20.4 Verify docs in CI
Typed-link tests catch documentation drift; OpenSpec edits belong in the same change set as behavior.
Verify docs in CI
Website and Book changes run through bun run test:docs-links and bun run build in site/website. Normative changes are validated separately from the repository root with openspec validate --all --strict.
Run the checks that match the change: link checks for Book navigation, the site build for rendered pages, and standard validation for changes to the normative corpus. A passing documentation build does not validate a changed language rule.
Contributor loop
Section titled “Contributor loop”- Change behavior → update platform-spec if observable.
- Update
///and runbeskid docfor packages you publish. - Run verify before claiming green CI.
If a rendered guide and the standard disagree, update or clarify the guide and keep the standard link visible. Do not copy a requirement into the Book merely to make the page self-contained.