awesome-readme/readme.md

# Awesome README > A curated list of awesome README

Inspired by the awesome list thing.

Elements in beautiful READMEs include, but not limited to: images, screenshots, GIFs, text formatting, etc.

Examples

• sindresorhus/pageres - Project logo. Clear description of what the project does. Build badges. Demo screenshot. Simple install and usage sections. Includes an examples section with common uses.
• petkaantonov/bluebird - Build badges. Clear description of what the project does. TOC for easy navigation. Project logo. Extensive explanations and examples.
• jakubroztocil/httpie - Description of what the project does. Demo screenshots. Project logo. TOC for easy navigation. Build badges. Quick and simple installation and usage sections. Includes an examples section.
• karan/joe - Project logo. Clear description of what the project does. GIF demo. Easy install and usage sections.
• aimeos/aimeos-typo3 - Project logo. Clear description of what the project does. Demo screenshot. TOC for easy navigation. Easy installation and setup sections with screenshots. Links for further reading.

Articles

• "How To Write A Readme" - Joshua Holbrook
• "How To Write A Great README" - Caleb Thompson (thoughtbot)
• "Readme Driven Development" - Tom Preston-Werner
• "Top ten reasons why I won’t use your open source project" - Adam Stacoviak

Contribute

Contributions are always welcome! Please read the contribution guidelines first.

License

To the extent possible under law, Matias Singers has waived all copyright and related or neighboring rights to this work.