Review checklist: docs

The rules are in website/AGENTS.md. This checklist is what a reviewer reads a docs change against.

Placement

The site follows the four kinds of documentation of the Diátaxis framework, one kind per section:

• The page is in the section of its kind. A how-to does not stop to explain the design (link to the concept instead); a reference page lists facts without steps; a concept page has no procedure.
• It is not a second copy. A fact that already has a home (a setting in the configuration reference, a flag in the CLI reference) is linked, not repeated.

Reader task first

• The first lines say what the reader can do with the page and when they need it, before any background.
• Steps are runnable as written: commands in order, with the values the reader has to replace marked. TestDocumentedFlagsExist (in internal/cli) fails a dexaflow command in a code block or code span that names a flag or subcommand the binary does not have.

New names first

• Examples use dexaflow, DEXAFLOW_* and dexaflow.yaml. leoflow, LEOFLOW_* and leoflow.yaml appear only where the page explains that they still work.
• No page pins a release to install by hand: use the {{< latest-version >}} shortcode. scripts/check-stale-versions.sh fails a page that tells readers to install a release older than the newest one (ADRs and other records under project/ are exempt). At a release cut it runs as --candidate <tag> and judges against the release being cut, since versions.json still names the GA it replaces.

The gates

• Docs moved with the code. A PR that changes a chart value, the authoring schema, a CLI command, a server setting, a migration or the OpenAPI document changes website/content/ too, or carries skip-docs with a Skip-docs: <reason> line (scripts/check-docs-updated.sh, run by the docs guard). scripts/docs-gap.sh reads the same rule back at release cut.
• Generated pages were regenerated, not edited. reference/cli/ comes from website/scripts/gen-cli.sh, reference/go/ from gen-go.sh, and the chart README from helm-docs (build the docs).
• Accepted ADRs were not edited. A changed decision is a new ADR.
• The site builds: hugo --gc --minify in website/, also run by make ci-local when Hugo is installed and by the website build workflow.