deploy-docs

deploy-docs.yml is the workflow that turns the checked-in handbook into the published site.

It matters because documentation in this repository is treated as a maintained surface, not as an optional by-product. The deploy workflow is therefore part of the documentation contract, not a secondary convenience step.

It runs on main when docs-related files change and can also be started manually. The job tree stays small on purpose: build the strict site, validate the published assets, then deploy the Pages artifact.

Workflow Anchors

• .github/workflows/deploy-docs.yml
• mkdocs.yml and mkdocs.shared.yml
• docs/ as the published source tree

Purpose

Use this page to understand when documentation publication runs and which site inputs it validates before deploy.

Stability

Keep it aligned with the docs deployment workflow and the published handbook inputs it relies on.