Contributing

Contributing Guidelines

  • Follow Angular’s commit message convention for PRs. - This applies to PR’s title and ultimately the commit messages in main. - The prefix shall be one of build, ci, docs, feat, fix, perf, refactor, test. - Use lowercase.

  • Code style is enforced by pre-commit hooks locally and by the Lint CI workflow on every push and PR. Hooks run: trailing-whitespace remover, end-of-file fixer, black (v24.2.0), and ruff linter. Setup once with:

    pip install pre-commit
    pre-commit install
    

    Run manually on all files with pre-commit run --all-files.

Building Documentation

To build and view the documentation locally:

# Build the documentation
cd docs
make html

# Start a local server to view the documentation
python -m http.server 8000 --directory _build/html

Then open your browser and navigate to http://localhost:8000 to view the documentation.

Build with CamTools

If you use CamTools in your project, consider adding one of the following badges to your project.

Built with CamTools Built with CamTools