trying to clarify contribution guidelines

This commit is contained in:
phre4k 2015-04-05 13:56:08 +02:00
parent adfaebbc22
commit c5494c5a63

View File

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