Awesome-Mirrors/awesome-readme
1
0
Fork 0
mirror of https://github.com/matiassingers/awesome-readme.git synced 2024-10-01 01:05:56 -04:00
Code Issues Packages Projects Releases Wiki Activity
A curated list of awesome READMEs
32 Commits 3 Branches 0 Tags 4 MiB
Markdown 100%
c87b0968e4
Go to file
Richard Littauer c87b0968e4 Add Standard Readme 
Ive added standard-readme, my specification for how READMEs should look, aimed to help make creating and maintaining good READMEs easier. I know its mine, but I think it belongs on this list, and would love your opinion on it, too.
2016-11-15 00:47:33 +09:00
.travis.yml Create .travis.yml 2015-12-24 12:11:59 +01:00
contributing.md Create contributing.md 2015-01-19 14:20:32 +08:00
icon.png Decrease icon size 2015-01-19 14:40:55 +08:00
readme.md Add Standard Readme 2016-11-15 00:47:33 +09:00

readme.md

# Awesome README [![Awesome](https://cdn.rawgit.com/sindresorhus/awesome/d7305f38d29fed78fa85652e3a63e154dd8e8829/media/badge.svg)](https://github.com/sindresorhus/awesome) > A curated list of awesome README

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.
  • rstacruz/hicat - GIF demo. Easy installation and setup sections with screenshots. Build badges. Great examples of use cases.
  • skywinder/github-changelog-generator - TOC for easy navigation. Concise project description. Installation and usage sections. Output example. Great feature overview. List of alternatives. FAQ.
  • shama/gaze - Project logo. Concise description. Feature list. Usage section. FAQ. Great API documentation. Release history.
  • node-chat - Project screenshot. Informative badges. Clear description. Easy installation/use instructions. Live demo.
  • b4b4r07/dotfiles - Testing my dotfiles repo on OS X to get my work environment ready in just a few moments. #VIM + #ZSH + #TMUX = Best Developer Environment.

Articles

Tools

  • Standard Readme - A standard readme style specification. Has a generator to help creat spec-compliant readmes, too.

Contribute

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

License

CC0

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