mirror of
https://github.com/awesome-lists/awesome-bash.git
synced 2024-10-01 01:25:35 -04:00
Update contributing.md
This commit is contained in:
parent
562358fbad
commit
5abf1fe5f2
@ -1,47 +1,51 @@
|
|||||||
# Contribution Guidelines
|
# Contribution Guidelines
|
||||||
|
|
||||||
Please note that this project is released with a [Contributor Code of Conduct](code-of-conduct.md). By participating in this project you agree to abide by its terms.
|
Contributions are welcome! Note that this project has a [Contributor Code of Conduct](./code-of-conduct.md); by participating in this project, you agree to abide by its terms.
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## App to be submitted
|
## New Links
|
||||||
|
|
||||||
Thank you for your suggestions!
|
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.
|
||||||
|
|
||||||
Note, however, that not everything will be considered. The aim of the list is to provide a concise set of awesome Bash scripts and resources. This means that suggestions should, where applicable:
|
It is highly recommended to meet the following requirements.
|
||||||
|
|
||||||
- Use or refer to Bash directly (i.e. there are more appropriate Awesome Lists tracking general CLI tools).
|
- Source code resources must:
|
||||||
- Do one thing and do it well.
|
- Be older than 90 days
|
||||||
- Have a free and open source license.
|
- Have more than 50 stars
|
||||||
- Be easy to install.
|
- Non-source code resources must:
|
||||||
- Be well documented.
|
- 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](https://reddit.com/), [Hacker News](https://news.ycombinator.com/), or [Lobster](https://lobste.rs/) post
|
||||||
- Have a decently active community and engaged ownership.
|
|
||||||
|
|
||||||
## Pull Request Style
|
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
|
#### Ground Rules
|
||||||
|
|
||||||
- No duplicates.
|
- No duplicate links
|
||||||
- Individual pull request for each suggestion.
|
- _Create a pull request for each individual suggestion_
|
||||||
- For source code repositories:
|
|
||||||
- The repository is older than 90 days.
|
|
||||||
- The repository has more than 50 stars.
|
|
||||||
- For non-source resource lins:
|
|
||||||
- Include links to positive discussions indicating this resource has a strong, positive community backing, e.g. a [Reddit](https://reddit.com/), [Hacker News](https://news.ycombinator.com/), [Lobster](https://lobste.rs/), or similiar post.
|
|
||||||
|
|
||||||
#### Formatting & Style
|
#### Formatting & Style
|
||||||
|
|
||||||
- The pull request shall be titled: `Add ITEM_NAME`.
|
- The pull request must be titled: `Add ITEM_NAME`
|
||||||
- The item is added at the bottom of the relevant category.
|
|
||||||
- Use the following format: `[ITEM_NAME](LINK) - DESCRIPTION.`
|
- Use the following format: `[ITEM_NAME](LINK) - DESCRIPTION.`
|
||||||
- Description starts with a capital and ends with a full stop (period).
|
- Description starts with a capital and ends with a full stop (period)
|
||||||
- Try to keep it short and concise.
|
- Try to keep it short and concise
|
||||||
- No trailing whitespace.
|
- No trailing whitespace
|
||||||
- Check your spelling and grammar.
|
- Check your spelling and grammar
|
||||||
|
- The item is added at the bottom (or alphabetical) of the relevant category
|
||||||
|
|
||||||
|
|
||||||
### Other Pull Requests
|
### 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.
|
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
|
### Updating your PR
|
||||||
|
|
||||||
|
Loading…
Reference in New Issue
Block a user