Administrator Guide
Status: Scaffold only. No legacy page has been promoted into this book yet.
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 — existing navigation is transitional and still contains legacy paths.
- Product requirements — normative requirements, currently marked draft.
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. | Scaffold only. |
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— historical source; verify claims before promotion._old_structure/guides/deployment.md— historical source; verify commands and deployment assumptions before promotion.
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.