mirror of
https://github.com/awesome-foss/awesome-sysadmin
synced 2024-11-06 21:20:23 +00:00
trying to clarify contribution guidelines
This commit is contained in:
parent
adfaebbc22
commit
c5494c5a63
@ -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.
|
||||
|
Loading…
Reference in New Issue
Block a user