Contributing a new feature¶
Open a new Github pull request with the patch.
Ensure the PR description clearly describes the problem and solution. Include the relevant issue number if applicable.
There are tools available to ease the development cycle. These can be called from the root directory with the
The following commands are supported:
make lint make install make examples make docs make test make clean make typing
The git workflow used in this project is based on this blog post. Using this workflow allows for better collaboration between contributors and automation of repetitive tasks.
In addition to the workflow described in the blog post, Github Actions lints the code automatically on the release branches and builds documentation from each push to the master branch. For now, we don’t use hotfix branches.
Branch naming: - develop: development branch - master: master branch - feature/[FEATURE NAME]: feature branches - release/v[VERSION]: releases - gh-pages: documentation and examples are hosted here
Contributor License Agreement (CLA)¶
This package does not have a Contributor License Agreement (CLA), as the GitHub Terms of Service provides a sensible explicit default:
Whenever you make a contribution to a repository containing notice of a license, you license your contribution under the same terms, and you agree that you have the right to license your contribution under those terms.
Read Github’s open source legal guide for further details.