Please note that this project is released with a Contributor Code of Conduct. By participating in this project you agree to abide by its terms.
The pull request should have a useful title. Pull requests with Update readme.md
as title will be closed right away because I'm so tired of nobody reading this document. Please carefully read everything in Adding to this list
.
- Adding to this list
- Creating your own awesome list
- Adding something to an awesome list
- Updating your Pull Request
Please ensure your pull request adheres to the following guidelines:
- Search previous suggestions before making a new one, as yours may be a duplicate.
- Make an individual pull request for each suggestion.
- Chose corresponding section (Programming Languages or General) for your suggestion.
- Use the following format:
[List Name
without awesome](link)
- Use the following format for commit message:
Add Language Name
(without 'awesome' or something else). - New categories or improvements to the existing categorization are welcome.
- Check your spelling and grammar.
- List, after your addition, should be alphabetically.
- The pull request and commit should have a useful title.
- The body of your commit message should contain a link to the repository.
Thank you for your suggestions!
To create your own list, check out the instructions.
If you have something awesome to contribute to an awesome list, this is how you do it.
You'll need a GitHub account!
- Access the awesome list's GitHub page. For example: https://github.com/sindresorhus/awesome
- Click on the
readme.md
file: - Now click on the edit icon.
- You can start editing the text of the file in the in-browser editor. Make sure you follow guidelines above. You can use GitHub Flavored Markdown.
- Say why you're proposing the changes, and then click on "Propose file change".
- Submit the pull request!
Sometimes, a maintainer of an awesome list will ask you to edit your Pull Request before it is included. This is normally due to spelling errors or because your PR didn't match the awesome-* list guidelines.
Here is a write up on how to change a Pull Request, and the different ways you can do that.