mirror of
https://github.com/agarrharr/awesome-cli-apps
synced 2024-12-22 12:50:38 +01:00
Rework and structure contrib guidelines
This commit is contained in:
parent
dc73a20070
commit
1b40740662
@ -1,5 +1,7 @@
|
|||||||
# Contribution Guidelines
|
# Contribution Guidelines
|
||||||
|
|
||||||
|
## App to be submitted
|
||||||
|
|
||||||
Not all tools can be considered. The aim of the list is to provide a concise list of awesome CLI tools and apps. This means that suggested software should:
|
Not all tools can be considered. The aim of the list is to provide a concise list of awesome CLI tools and apps. This means that suggested software should:
|
||||||
|
|
||||||
- Do one thing and do it well
|
- Do one thing and do it well
|
||||||
@ -7,18 +9,26 @@ Not all tools can be considered. The aim of the list is to provide a concise lis
|
|||||||
- Be easy to install
|
- Be easy to install
|
||||||
- Be well documented
|
- Be well documented
|
||||||
|
|
||||||
Please ensure your pull request adheres to the following guidelines:
|
## Pull Request Style
|
||||||
|
|
||||||
- Search previous suggestions before making a new one, as yours may be a duplicate.
|
**Ground Rules:**
|
||||||
- Make an individual pull request for each suggestion.
|
|
||||||
- Additions should be added to the bottom of the relevant category.
|
- No duplicates.
|
||||||
- Use the following format: `[package](link) - Description.`
|
- Individual pull request for each suggestion.
|
||||||
- New categories, or improvements to the existing categorization are welcome.
|
|
||||||
- Keep descriptions short and simple, but descriptive.
|
|
||||||
- Start the description with a capital and end with a full stop/period.
|
|
||||||
- Check your spelling and grammar.
|
|
||||||
- Make sure your text editor is set to remove trailing whitespace.
|
|
||||||
- The pull request should have a useful title like `Add app-xyz` and include a link to the app and why it should be included.
|
|
||||||
- The apps repository is older than 90 days.
|
- The apps repository is older than 90 days.
|
||||||
|
- The apps repository has more than 10 stars (if on Github).
|
||||||
|
|
||||||
Thank you for your suggestions!
|
|
||||||
|
**Formatting & Style:**
|
||||||
|
|
||||||
|
- The pull request shall be titled: `Add APP_NAME`.
|
||||||
|
- The app is added at the bottom of the relevant category.
|
||||||
|
- Use the following format: `[APP_NAME](LINK) - DESCRIPTION.`
|
||||||
|
- Description starts with a capital and ends with a full stop (period).
|
||||||
|
- A description should be short and concise. No redudant info like "CLI".
|
||||||
|
- No trailing whitespace.
|
||||||
|
- Check your spelling and grammar.
|
||||||
|
|
||||||
|
## General Pull Request Notes
|
||||||
|
|
||||||
|
Pull requests that are not adding a new app, but introduce new categories or improve the readme are always welcome! In that case feel free to disregard the given structure above.
|
||||||
|
Loading…
x
Reference in New Issue
Block a user