Hi there! We’re thrilled that you’d like to contribute to this project. Your help is essential for keeping this project great and for making it better.
In general, contributors should develop on branches based off of master and
pull requests should be made against master.
It is recommended that you commit code to your branches often. Prior to pushing the code and submitting PRs, please try to clean up your branch by squashing multiple commits together and amending commit messages as appropriate. See these pages for details: https://blog.carbonfive.com/2017/08/28/always-squash-and-rebase-your-git-commits https://git-scm.com/book/en/v2/Git-Tools-Rewriting-History
- Please read our [code of conduct](code-of-conduct.md] and license.
- Fork and clone the repository.
- Create a new branch based on
master:git checkout -b <my-branch-name> master. - Make your changes, add tests, and make sure the tests still pass.
- Commit your changes using the DCO. You can attest to the DCO by commiting with the -s or --signoff options or manually adding the "Signed-off-by".
- Push to your fork and submit a pull request from your branch to
master. - Pat yourself on the back and wait for your pull request to be reviewed.
Here are a few things you can do that will increase the likelihood of your pull request to be accepted:
- Follow the existing style where possible.
- Write tests.
- Keep your change as focused as possible. If you want to make multiple independent changes, please submit them as separate pull requests.
- Write a good commit message.