Files
ironclaw/docs
Josh Ford ad7ecd1f69 docs(internal): doc-truth pipeline design record (doc-truth PR 5/5) (#7381)
* docs(internal): record the doc-truth pipeline design (issue #7317)

The as-built design for keeping the public Mintlify docs in sync with
released binaries: the problem evidence, the decisions of record (single
doc tree deploying from a docs-live branch; deterministic gates only;
human-curated changelog), the three enforcement layers (PR-time static
gates, release-time cut/publish automation, human checklist), a
surface-to-gate enforcement table, the deferred follow-ups (release-time
live probes on the packaged binary, an openwiki-style non-blocking LLM
fix-PR generator, flag-level CLI coverage, link integrity, zh freshness,
contract-doc pinned-test re-verification), and the risk register.

Part of #7317 (doc-truth pipeline, PR 5 of 5). Companions: #7375 #7376
#7378 #7379.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

* docs(internal): record review hardening in the doc-truth design

Post-implementation review found five gaps; this records their
resolutions where the design doc already claims the guarantees:
planner routing so doc-fact tests run on docs-only PRs, the
changelog entry landing on main before the Monday cut, a
newest-stable-tag guard on publish-docs-live, the force-push
allowance in the docs-live branch-protection shape, and the
docs-hotfix repoint recipe.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

---------

Co-authored-by: Claude Fable 5 <noreply@anthropic.com>
2026-08-11 01:01:16 +00:00
..