awesome-readme/readme.md

<img src="icon.png" align="right" />
# Awesome README
> A curated list of awesome README

Inspired by the [awesome](https://github.com/sindresorhus/awesome) list thing.

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


## Examples
- [sindresorhus/pageres](https://github.com/sindresorhus/pageres)
- [petkaantonov/bluebird](https://github.com/petkaantonov/bluebird)
- [jakubroztocil/httpie](https://github.com/jakubroztocil/httpie)
- [karan/joe](https://github.com/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](http://jesusabdullah.github.io/2011/11/09/readmes.html)
- [How To Write A Great README](http://robots.thoughtbot.com/how-to-write-a-great-readme)
- [Readme Driven Development](http://tom.preston-werner.com/2010/08/23/readme-driven-development.html)
- [Top ten reasons why I won’t use your open source project](http://thechangelog.com/top-ten-reasons-why-i-wont-use-your-open-source-project/)


## Contribute

Contributions are always welcome!
Please read the [contribution guidelines](contributing.md) first.


## License

[![CC0](http://i.creativecommons.org/p/zero/1.0/88x31.png)](http://creativecommons.org/publicdomain/zero/1.0/)

To the extent possible under law, [Matias Singers](http://mts.io) has waived all copyright and related or neighboring rights to this work.