# Contributing Guide

We welcome pull requests!  Please follow these steps:

1. Fork the repository and create a feature branch.
2. Install dev dependencies: `pip install -e .[dev]`.
3. Run `pre-commit install` to enable linters.
4. Add or update **tests** – we aim for >95 % coverage.
5. Ensure `pytest -q` passes.
6. Submit a PR; GitHub Actions will run the test & docs matrix.

## Coding style
* `ruff` enforces import order & flake-like rules.
* Type hints are mandatory for new code.

## Docs
All docs live under `docs/` and are built by Sphinx.  Add a new `.md` page and reference it in `_toc.yml`.