Documentation subproject

The documentation build configuration is stored as its own subproject, a copy of the Sphinx Stack. Updating and managing this subproject happens separately from the main app.

The Sphinx Stack documentation describes the officially-supported features and provides guidance for customizing the docs.

Update the docs subproject

The goal is to override the build configuration of the Sphinx Stack as little as possible, so when changes come we don't have to create them. The process isn't completely automatic.

First, run the update script:

make docs-update

The script will inform you of the files that have changed. Go through each notification and make the proper adjustments so the new and updated features work properly.

In pyproject.toml, remove everything in the docs-sphinx-stack group.

Then, sync the docs dependencies to the parent project:

make clean
make docs-setup
uv add -r docs/requirements.txt --group docs-sphinx-stack

For safety, test the three main doc commands:

make docs
make docs-auto
make docs-lint