Skip to content

Latest commit

 

History

History
47 lines (28 loc) · 2.83 KB

CONTRIBUTING.md

File metadata and controls

47 lines (28 loc) · 2.83 KB

Contributing to markdown-badges

🎉 First off, thanks for taking the time to contribute! 🎉

The following steps are a set of guidelines for contributing to markdown-badges:

  1. Create a fork of the existing repository. This will be your local copy where you can propose new changes.

  2. Update the local clone or make changes directly on the forked repo, adding a badge with its appropriate hex-color in the given format:

  3. Copy this markdown 👇

    ![Badge Name](https://img.shields.io/badge/<badge>-%23<badge-color>.svg?style=for-the-badge&logo=<badge>&logoColor=<logo-color>)

  4. 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.

  5. 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. 🎊


🖋️ When thinking of where to add your badge:

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.

🖋️ When your badge doesn't fit into any of the existing categories:

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, use Finance
  • Use a title that obeys the what they do principle above.
  • Place your shiny new category in the right alphabetical position.

Thanks! again to ALL the amazing contributors! 🙏