diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 041be79..def4ecb 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -1,22 +1,22 @@ # Contribution Guidelines -Ensure your pull request adheres to the following guidelines: -* This is an open source compilation. - * Check the license of the software is suitable. +This is a compilation of **Free and Libre Open Source Software ([FLOSS](https://en.wikipedia.org/wiki/Free_and_open-source_software))**. Restrictive licenses (aka Freeware, Shareware) are *not awesome*. + +## Commits * Search previous suggestions before making a new one. - * Don't create duplicates. +* Use the following format: `[RESOURCE](LINK) - DESCRIPTION.` + * Keep descriptions short (<80 characters). + * End descriptions with a full stop. * Make an individual commit for each category. - * Consolidate multiple commits to a pull request. -* In pull request descriptions: - * Use imperative (e.g. add instead of added/adding). - * Include application names and categories. - * Include a link to the open source project page. - * Example: *Add mosh, openSSH to SSH* -* Use the following format: \[RESOURCE\]\(LINK\) - DESCRIPTION. - * Keep descriptions short. - * End descriptions with a full stop/period. -* Order projects alphabetically within each category. -* Check spelling and grammar. -* Improvements to the existing categorisation are welcome. + * Order projects alphabetically. + * Consolidate multiple commits. + +## Pull Requests +* Use imperative (e.g. add instead of added/adding) in the PR title. +* Include application names, categories and a link to the open source project page in the description. -Thank you very much for your suggestions! +## Issues +* Discussion, questions and bug reports only. +* If you are sure software meets the guidelines, create a Pull Request (see above). +* Check spelling and grammar. +* Suggestions for improvements to existing structure are welcome.