Skip to content

Latest commit

 

History

History
52 lines (34 loc) · 2.33 KB

contributing.md

File metadata and controls

52 lines (34 loc) · 2.33 KB
Raw

Contribution Guidelines

Contributions are welcome! Note that this project has a Contributor Code of Conduct; by participating in this project, you agree to abide by its terms.

New Links

Any and all suggestions are appreciated! Please note that suggestions are not guaranteed to be added. Not everything will be considered for inclusion. It is recommended to conform to the recommendations as laid out below.

It is highly recommended to meet the following requirements.

  • Source code resources must:
    • Be older than 90 days
    • Have more than 50 stars
  • Non-source code resources must:
    • Include at least 1 link (in the PR) to positive discussions that indicates the resource has a strong, positive community backing. For example, a Reddit, Hacker News, or Lobster post

If the resource links to source code, it is recommended for it to:

  • Do one thing and do it well
  • Have a free and open source software license
  • Be easy to install
  • Be well documented
  • Have a decently active community and engaged ownership
  • Use Bash directly (general CLI tools should go in a different Awesome List)

Pull Requests

Ground Rules

  • No duplicate links
  • Create a pull request for each individual suggestion

Formatting & Style

  • The pull request must be titled: Add ITEM_NAME
  • Use the following format: [ITEM_NAME](LINK) - DESCRIPTION.
    • Description starts with a capital and ends with a full stop (period)
      • Try to keep it short and concise
    • No trailing whitespace
    • Check your spelling and grammar
  • The item is added at the bottom (or alphabetical) of the relevant category

Other Pull Requests

Pull requests that introduce new categories or improve the README are always welcome! In that case, feel free to disregard the given structure above.

Updating your PR

A lot of times, making a PR adhere to the standards above can be difficult. If the maintainers notice anything that we'd like changed, we'll ask you to edit your PR before we merge it. There's no need to open a new PR, just edit the existing one. If you're not sure how to do that, here is a guide on the different ways you can update your PR so that we can merge it.