Documentation is built with Sphinx and follows the same steps used in CI (.github/workflows/deploy.yml).
From the repository root:
# Automatically generate API docs from docstrings
uv run sphinx-apidoc -o docs/source/ slate_quantum/
# Build the docs
cd docs
make htmlThe generated site is written to:
docs/build/html/
Open docs/build/html/index.html in a browser to preview the docs locally.
- On pushes to
main, GitHub Actions builds the docs and deploys them to GitHub Pages via .github/workflows/deploy.yml. - Pull requests to
mainrun lint/type/test checks via .github/workflows/test.yml.