Summary

Umbrella tracker for the remaining lower-severity documentation drift found during the multi-pass docs-correctness review (PR #1528). #1528 fixed the P1s and the bulk of P2 prose; this issue captures the long tail that remains, to be cleaned up incrementally rather than growing #1528 further.

Remaining items (P2/P3)

Stale bundle-layout examples (current output uses numbered NNN-<component>/ dirs, root checksums, per-component install.sh, cluster-values.yaml, no undeploy.sh):

• docs/user/api-reference.md (~L487), docs/user/tutorial.md (~L76), README.md (~L97), and several demos/*.

data-flow.md architecture drift:

• Claims snapshot fields (K8s version, images, kernel, OS version) become recipe criteria; criteria only contain service/accelerator/intent/OS-family/platform/node-count.
• Describes a parallel bundler registry and a nonexistent ScriptData type.

Contributor-guide correctness:

• tests.md recommends Cobra's cmd.SetOut in an urfave/cli v3 codebase.
• "fail-fast"/"silently skipped" descriptions that contradict fail-closed behavior; make qualify described as checking BOM freshness; coverage decrease called "blocking" rather than "flagged"; / described as bypassing middleware; stdout described as the CTRF message.

Demos non-runnable:

• demos/end-to-end-cli.md uses removed recipe --criteria.
• demos/bundle-attestation* modifies an unnumbered bundle path that no longer exists.

Other user-facing:

• Impossible GPU.info.type constraint path; incorrect saved-recipe --data persistence semantics; binary SBOMs described as embedded rather than separate GoReleaser artifacts; a wget invoked inside a distroless server image.

One live 404: demos/cuj2-demo.md (~L306) links to nonexistent docs/conformance/cncf/submission; surrounding component count + bundle layout also stale.

Related

• PR docs: full correctness audit — fix drift across docs, demos, ADRs #1528 (docs correctness sweep) — fixed P1s + most P2 prose.
• Conformance evidence: 3 tests pass without exercising the capability they prove #1529 (conformance test rigor), Evidence signing: unsigned-commit flow contradicts pointer contract; sign script scans wrong path #1530 (evidence signing flow), POST /v1/bundle: documented 'bundlers' query param is silently ignored #1531 (bundlers param), OpenShift readiness gate Role lacks operators.coreos.com RBAC to read CSV #1532 (OCP gate RBAC).