2016-05-31 09:52:08 +00:00
2017-04-01 06:09:47 +00:00
<!-- Congrats on creating an Awesome list! 🎉 -->
2016-05-31 09:52:08 +00:00
2017-04-01 06:09:47 +00:00
<!-- Please fill in the below placeholders -->
**[Insert URL to the list here]**
**[Explain what this list is about and why it should be included here]**
2016-06-16 10:01:20 +00:00
2016-05-31 09:52:08 +00:00
2016-11-18 12:50:14 +00:00
# By submitting this pull request I confirm I've read and complied with the below requirements.
2017-04-01 06:09:47 +00:00
**Please read it multiple times. I spent a lot of time on these guidelines and most people miss a lot.**
2016-11-18 12:50:14 +00:00
- I have read and understood the [contribution guidelines ](https://github.com/sindresorhus/awesome/blob/master/contributing.md ) and the [instructions for creating a list ](https://github.com/sindresorhus/awesome/blob/master/create-list.md ).
2017-04-01 06:09:47 +00:00
- This pull request has a descriptive title.< br > For example, `Add Name of List` , not `Update readme.md` or `Add awesome list` .
- The entry in the Awesome list should:
2017-04-30 10:31:53 +00:00
- Include a short description about the project/theme of the list. **It should not describe the list itself.** < br > Example: `- [Fish](…) - User-friendly shell.` , not `- [Fish](…) - Resources for Fish.` .
2017-04-01 06:09:47 +00:00
- Be added at the bottom of the appropriate category.
- The list I'm submitting complies with these requirements:
- **Has been around for at least 30 days.**< br > That means 30 days from either the first real commit or when it was open-sourced. Whatever is most recent.
- It's the result of hard work and the best I could possibly produce.
- Non-generated Markdown file in a GitHub repo.
2017-04-30 10:31:53 +00:00
- **Includes a succinct description of the project/theme at the top of the readme.** [(Example) ](https://github.com/willempienaar/awesome-quantified-self )
- The repo should have `awesome-list` & `awesome` as [GitHub topics ](https://help.github.com/articles/about-topics ). I encourage you to add more relevant topics.
2017-04-01 06:09:47 +00:00
- Not a duplicate.
- Only has awesome items. Awesome lists are curations of the best, not everything.
- Includes a project logo/illustration whenever possible.
2017-09-25 19:07:19 +00:00
- Either fullwidth or placed at the top-right of the readme. [(Example) ](https://github.com/sindresorhus/awesome-electron )
2017-04-01 06:09:47 +00:00
- The image should link to the project website or any relevant website.
- The image should be high-DPI. Set it to maximum half the width of the original image.
- Entries have a description, unless the title is descriptive enough by itself. It rarely is though.
2017-08-11 00:09:45 +00:00
- Includes the [Awesome badge ](https://github.com/sindresorhus/awesome/blob/master/awesome.md#awesome-badge ).
- Should be placed on the right side of the readme heading.
- Should link back to this list.
2017-04-01 06:09:47 +00:00
- Has a Table of Contents section.
- Should be named `Contents` , not `Table of Contents` .
- Should be the first section in the list.
2017-07-07 21:45:54 +00:00
- Should only have one level of sub-lists, preferably none.
2017-04-01 06:09:47 +00:00
- Has an [appropriate license ](https://github.com/sindresorhus/awesome/blob/master/awesome.md#choose-an-appropriate-license ).
- That means something like CC0, **not a code licence like MIT, BSD, Apache, etc.**
2017-11-04 09:02:14 +00:00
- [WTFPL ](http://www.wtfpl.net ) and [Unlicense ](http://unlicense.org ) are not acceptable licenses.
2017-04-01 06:09:47 +00:00
- If you use a license badge, it should be SVG, not PNG.
- Has [contribution guidelines ](https://github.com/sindresorhus/awesome/blob/master/awesome.md#include-contribution-guidelines ).
- The file should be named `contributing.md` . Casing is up to you.
- Has consistent formatting and proper spelling/grammar.
2017-09-25 19:07:19 +00:00
- The link and description are separated by a dash. < br > Example: `- [AVA](…) - JavaScript test runner.`
- The description starts with an uppercase character and ends with a period.
2016-11-18 12:50:14 +00:00
- Drop all the `A` / `An` prefixes in the descriptions.
2017-04-30 10:31:53 +00:00
- Consistent and correct naming. For example, `Node.js` , not `NodeJS` or `node.js` .
2017-04-01 06:09:47 +00:00
- Doesn't include a Travis badge.< br > You can still use Travis for list linting, but the badge has no value in the readme.
- Go to the top and read it again.