2
0
mirror of https://github.com/alexanderepstein/Bash-Snippets synced 2018-11-08 02:59:35 +01:00
Bash-Snippets/CONTRIBUTING.md

48 lines
2.2 KiB
Markdown
Raw Normal View History

2017-06-28 05:23:21 +02:00
# Contributing
2017-06-28 06:07:37 +02:00
### First off, thank you for considering contributing to Bash-Snippets.
2017-06-28 05:23:21 +02:00
2017-06-28 06:07:37 +02:00
#### Where do I go from here?
2017-06-28 05:23:21 +02:00
If you've noticed a bug or have a question, search the <a href="https://github.com/alexanderepstein/Bash-Snippets/issues">issue tracker</a> to see if someone else in the community has already created a ticket. If not, go ahead and <a href="https://github.com/alexanderepstein/Bash-Snippets/issues/new">make one</a>!
#### Otherwise if implementing a fix, feature or new component go through these steps
2017-06-28 06:07:37 +02:00
#### 1. Fork & Clone The Repository
2017-06-28 05:23:21 +02:00
* Fork the repository
* It is assumed you are on either a Unix or Linux system in which are there are no dependencies
* To download the full source code after forking
```bash
git clone https://github.com/yourusernamehere/Bash-Snippets
```
#### 2. Implement your fix, feature or new component
2017-06-28 05:23:21 +02:00
###### Fix/Feature
At this point, you're ready to make your changes!
###### New Component
* Decide on a short but sweet name for your tool
* Create a folder in the Bash-Snippets root directory named after the tool
* Copy over the Bash-Snippets tool [skeleton](https://github.com/alexanderepstein/Bash-Snippet/blob/master/skeleton) to the newly created folder
* Rename the skeleton in the new directory to the name of the tool
* Using newly copied over file as a basis (with the name of your tool) code your new component!
Feel free to ask for help; everyone is a beginner at first :smile_cat:
2017-06-28 05:23:21 +02:00
Make sure to make your commit messages informative and concise.
2017-06-28 06:07:37 +02:00
#### 3. Check The Script Runtime
2017-06-28 05:23:21 +02:00
If you changed the weather script for example try running it and see if it works as intended. Run ```bats tests``` when inside the Bash-Snippets directory to test the tools.
2017-06-28 05:23:21 +02:00
If you added a new script/tool test it to see if it works.
2017-06-28 06:07:37 +02:00
#### 4. Create A Pull Request
2017-06-28 05:23:21 +02:00
First make sure to commit and push your changes to your forked repository.
Check to see if there are any conflicts with the main repository and your fork.
If there are none submit the request and give details as to what you changed or added.
2017-06-28 06:07:37 +02:00
#### 5. Bask In All The Glory Of Adding To A FOSS Application
2017-06-28 05:23:21 +02:00
![Had to do it to em](https://68.media.tumblr.com/2dfc3369827df9b981e111d7fd8fc732/tumblr_mvemcyarmn1rslphyo1_400.gif)