# 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
• petkaantonov/bluebird
• jakubroztocil/httpie
• karan/joe - Project logo/icon. Clear description of what the project does. GIF demo. Easy install and usage sections.

Articles

• How To Write A Readme
• How To Write A Great README
• Readme Driven Development
• Top ten reasons why I won’t use your open source project

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.