🎉 First off, thanks for taking the time to contribute! 🎉
-
Create a fork of the existing repository. This will be your local copy where you can propose new changes.
-
Update the local clone or make changes directly on the forked repo, adding a badge with its appropriate hex-color in the given format:
-
Copy this markdown 👇
![Badge Name](https://img.shields.io/badge/<badge>-%23<badge-color>.svg?style=for-the-badge&logo=<badge>&logoColor=<logo-color>)
-
Replace the following:
<badge>
,<badge-color>
,<logo-color>
🔥 Important: All of the badges are ordered alphabetically. Hence, while contributing, make sure to order to add the new badges in an alphabetical order.
💡 Tip: You can check available icons for your
<badge>
in Simple Icons slugs or Simple Icons website. -
Create a Pull Request with your proposed changes.
Yayyy, You are all done with the steps! Now just sit back and watch while your Pull request is reviewed and ultimately merged. 🎊
Favor general, i.e. widely known, categories rather than specific (sometimes unknown) categories, so that it is easier to find. For instance, when a person thinks of Tor Browser, they'd want to find it where other browsers are listed.
Similarly, we have several Google products (Play, Drive, Chrome, etc), however, they are not listed under a category for Google.
Think of the categories as what they do
rather than who they are
.
So, instead of a category titled Google for instance, Chrome would be placed in a category like Browser.
Having the categories based on who they are
will quickly become clumsy. And clumsy doesn't feel right.
We've covered lots of ground and categories but if you find that your new badge doesn't fit into an existing category, create a new one. It would be lovely having a new category around.
Some Guidelines for starting a new category:
- Check the existing categories one more time to be really sure your new badge won't fit into one. 😄
- Use a simple title. For example, instead of
Banks and money companies
, useFinance
- Use a title that obeys the
what they do
principle above. - Place your shiny new category in the right alphabetical position.