jason.woltje
3ae1411d5f
Addresses CPS-PRD-REV1-REREVIEW findings on PR #1491 head 13968e9a:
F1 (blocker; the CI test failure): docs/PRD.md is now the permanent shim, so
heading-fragment links into the former PRD body no longer resolve —
fleet-documentation.spec.ts failed on docs/fleet/README.md's FCM anchor. The
Part II workstream contracts live in
docs/PRDs/2026-08-31_PRD_rev1/GOV.4-workstream-contracts.md; all five anchored
links in the tree are repointed there (fleet/README.md, TASKS.md,
release-integrity/TASKS.md, ADMIN-GUIDE mos-connector-lease-operations.md,
DEVELOPER-GUIDE mos-runtime-portability-m1.md). Each anchor verified against
the GOV.4 headings with the spec's slug rule. Bundle content unchanged.
F2 (minor): the rev0 archive README's ./ROADMAP.md row now cites all three
source lines (18, 177, 249).
kind, status
| kind | status |
|---|---|
| guide | active |
Administrator Guide
Status: Partially migrated. Current SSO and local upgrade/recovery procedures are available; held procedures are labeled non-operative.
This book is the canonical home for installation, configuration, deployment, routine operations, security controls, incident response, and recovery. User workflows belong in USER-GUIDE/; implementation and contributor material belongs in DEVELOPER-GUIDE/.
Start here
- Documentation atlas — placement rules and source-of-truth boundaries.
- Documentation sitemap — resolvable current navigation and authority-gated migration summary.
- Product requirements — normative requirements, currently marked draft.
- Operations index — current local procedures and explicitly held operational outlines.
- Security index — current SSO provider configuration.
Chapter map
| Chapter | Scope | Status |
|---|---|---|
installation/ |
Prerequisites, installation, and first deployment. | Scaffold only. |
configuration/ |
Environment, provider, tier, and runtime configuration. | Scaffold only. |
deployment/ |
Topologies, rollout, migration, and upgrade procedures. | Scaffold only. |
operations/ |
Health, observability, routine operation, and maintenance. | Local upgrade/recovery is current; connector lease operations are held. |
security/ |
Authentication, authorization, SSO, secrets, and security controls. | SSO provider guide is current; other pages are planned. |
recovery/ |
Incident response, backup, rollback, and recovery. | Scaffold only. |
Every promoted page must be added to this index and to SITEMAP.md in the same migration slice.
Evidence — not current operator guidance
P8-003 performance report— historical performance evidence; implementation alignment is partial, and production metrics remain unverified. It is not an operational SLO or runbook.
Migration backlog — not current operator guidance
These are source candidates, not verified runbooks:
_old_structure/guides/admin-guide.md— quarantined historical source; verify claims before promotion._old_structure/guides/deployment.md— quarantined historical source; deployment commands and assumptions remain held.- See the documentation catalog for file-level dispositions.
Do not treat a migration candidate as current until its commands, paths, permissions, and safety status are checked against source and tests.
Authoring boundary
New administrator documentation belongs under one of the chapter directories above. Operationally sensitive pages must identify prerequisites, ownership, source-of-truth dependencies, and whether any procedure is current, illustrative, held, or non-operative.