2.2 KiB
Contributing
First off, thank you for considering contributing to Bash-Snippets.
Where do I go from here?
If you've noticed a bug or have a question, search the issue tracker to see if someone else in the community has already created a ticket. If not, go ahead and make one!
Otherwise if implementing a fix, feature or new component go through these steps
1. Fork & Clone The Repository
- 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
git clone https://github.com/yourusernamehere/Bash-Snippets
2. Implement your fix, feature or new component
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 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 😸 Make sure to make your commit messages informative and concise.
3. Check The Script Runtime
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.
If you added a new script/tool test it to see if it works.
4. Create A Pull Request
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.
5. Bask In All The Glory Of Adding To A FOSS Application
