Contributing
Contributions in the form of pull requests are very welcome! Here's how to get started.
Getting started
First, fork the library on GitHub. You can do this by clicking on the Fork
button in the GitHub interface.
Next, clone and install the library in development mode:
git clone git@github.com:YOUR_GIT_USERNAME/jaxdf.git
cd jaxdf
pip install poetry
poetry install
After that, install the pre-commit hooks:
pip install pre-commit
pre-commit install
If you're making changes to the code
Run git checkout -b my_contribution
and make your changes. Be sure to include additional tests if necessary. Increasing the coverage in the coverage report would be great! 😃
After making your changes, verify that all tests pass.
coverage run --source=jaxdf -m pytest -xvs
Once you are satisfied with your changes, add an entry to the changelog using kacl-cli, for example:
kacl-cli add fixed "Fixed the unfixable issue 🎉" --modify
For more information on the types of changes that can be added to the changelog, visit this page.
Then commit and push your changes back to your fork of the repository:
git push
Finally, open a pull request on GitHub! You can do this by clicking on the Pull Request button in the GitHub interface.
Wait for the CI to run, and one of the developers will review your PR.
If you're making changes to the documentation
Make your changes, and then build the documentation using:
mkdocs serve
Please note that due to the way operator
s are documented, this might take some time.
You can view your local copy of the documentation by navigating to localhost:8000
in a web browser.