Thank you for investing your time in contributing to our project!
In this guide, you will get an overview on how to contribute, open issues, open a PR, review and merge it.
To get an overview of the project, read the README. The README contains everything you need to get yourself started with your contributions to our Open Source Project.
If you spot any bugs with the existing code / contributions, head over to the Issues section and make sure the issue / bug is not already in the list of open issues. If you do not find the issue you want to report, you can open a new issue, by clicking on the New Issue button and filling up the form with the relavant information.
Scan through our existing issues to find one that interests you. You can assign to you, any issue that is open and start working on it. After you have solved an issue, open a Pull Request for review.
For any changes you make, be it solving an existing / new Issue, or contributing a new feature, make sure you:
- Fork the repository, if not already done.
- Ensure the base branch of your repository is in sync with that of the OS project.
- Create a new branch in your forked repository, specifically for the task you are doing.
- Clone the newly created branch from your repository to your local enviroment, perform the initial setup in the README and start working on your change.
After you've made your changes, make sure to self review to verify its working, and commit the changes once you are happy with them, with an appropriate commit message.
When you're finished with the changes, and have commited the same, create a pull request, also known as a PR.
- Head over to your repository and branch you want to merge. Click on Contribute and select Open pull request.
- Fill the form with a title relavant to the changes / additions that you're making, and add a relevant description and create a pull request.
- Be sure to check out the PR later, as we may request that you do some changes, before we merge the PR. The details of what needs to be changed can be found as comments in the PR.
- As you update your PR and apply changes, mark each conversation as resolved, or add relavent comments to indicate the changes made.
Yayyyyy!! Your PR is merged..🎊🎊 Now you can chill out or look for other issues to contribute to!!