3.2 KiB
Contributing
This document outlines the contribution workflow, starting from opening an issue, creating a pull request (PR), reviewing, and merging the PR. When working on this project, make sure to follow the Code of Conduct.
Thank you for your contribution.
New contributor guide
If you are a new open source contributor, here are some resources you may find useful before providing your first contributions:
- Finding ways to contribute to open source on GitHub
- Set up Git
- GitHub flow
- Collaborating with pull requests
Working on your first pull request? You can learn how from this free series How to Contribute to an Open Source Project on GitHub.
Create an issue
If you have any improvement ideas, notice a missing feature or a bug, create a GitHub issue by clicking Issues -> New issue in GitHub. Make sure to fill the issue template with a detailed description of the bug or suggested improvements. Provide proper argumentation and screenshots, if necessary.
If you find any existing issue to work on, you are welcome to open a PR with a fix.
Open a pull request
If you want to directly contribute to the project, create a pull reguest with the suggested changes. To do so:
-
Make changes on your local copy of the forked repository.
-
Commit and push the changes to GitHub.
Important
Don't forget to update your fork. Since many contributors may be working on the same content based on the
master
branch, some merge conflicts may occur. Remember to rebase withmaster
every time before pushing your changes and make sure your branch doesn't have any conflicts withmaster
. If you run into any merge conflicts, read the Resolve merge conflicts tutorial to learn how to resolve merge conflicts and other issues.
- Open a pull request in GitHub. Fill the pull request template with the reason and description for the provided changes. Link your pull request with the existing issue, if applicable. After submitting your PR, wait for the review from the project maintainers.
Review and approval process
After you submit your PR, wait for the review. The project maintainers will evaluate your changes and provide feedback either using suggested changes or pull request comments. Address the review suggestions and comments as soon as you can. If your PR looks good, the maintainers approve and merge it.
Contributors
All contributions get credit in Contributors. Don't forget to add yourself there.