What to include in your README to stand out against other repositories and marketing yourself to gain traction for open source projects.
- Write a project description
- What problem does it solve?
- What platform does it use? Mobile? Web? Both?
- Is it a gem/application/kata?
- List all the programming languages/frameworks/etc.
- Create a visualization that best represents how your repository functions
- Describe the installation process
- What dependencies are required to run the repository smoothly?
- Write usage instructions
- How does one use this?
- Include photos to advertise. GitHub is an app store for open source projects!
- Fork it!
- Create your feature branch:
git checkout -b my-new-feature
- Commit your changes:
git commit -am 'Add some feature'
- Push to the branch:
git push origin my-new-feature
- Submit a pull request
- Task 1
- Task 2
- Task 3
- Write history
- Write credits
- Write license
Great READMEs: