UIAO Customer Documents

Public-facing documentation portal for the UIAO Modernization Atlas

UIAO Customer Documents

This is the public-facing documentation portal for the UIAO Modernization Atlas. It is generated directly from the unified monorepo using Quarto — no external repositories, no derived mirrors. Everything a customer needs to understand, evaluate, and onboard the UIAO governance substrate lives here.

NoteScope

This portal exposes customer-visible material only. Internal governance canon, substrate control surfaces, and authoring workflows are deliberately excluded. See the Modernization section for the governance canon itself.

What lives here

This site is the canonical home for:

  • Executive briefs — single-page leadership summaries.
  • Architecture narratives — conceptual explainers for the UIAO model.
  • Modernization specs — cross-adapter technical specifications by domain.
  • Adapter specs — per-adapter operational designs and control mappings.
  • Validation suites — adapter + domain tests, evidence expectations, drift procedures.
  • Case studies — real-world deployment patterns and lessons learned.
  • Whitepapers — externally releasable long-form deep-dives.
  • Executive Governance Series — book-length governance narrative for authorizing officials and program leadership.
  • Platform — infrastructure runbooks (Windows Server 2025, IIS, Gitea, Intune, Azure Arc) with OrgTree integration.

Navigate by document family

Title Subtitle audience
Adapter Specs Per-adapter operational design, runtime profile, and control mapping Integrators · adapter implementers · control assessors
Architecture Series Conceptual explainers for the UIAO governance model Enterprise architects · technical leads · assessors
Case Studies Real-world deployment patterns and lessons learned Modernization sponsors · program leads · prospective customers
Executive Briefs Single-page leadership summaries of UIAO capability areas Agency CIO · CISO · modernization sponsors
Executive Governance Series Long-form governance narrative in nine chapters Authorizing officials · CIO · CISO · program leadership
Modernization Specs Cross-adapter technical specifications by modernization domain Modernization architects · program leads · control assessors
Platform Infrastructure build, operations, and runbooks for the UIAO governance substrate Platform engineers · sysadmins · integrators
Validation Suites Tests, evidence expectations, and drift procedures Assessors · adapter owners · ATO packagers
Whitepapers Externally releasable deep-dives on UIAO governance topics Federal CIO/CISO · assessors · research audience
No matching items

Download as DOCX

Every page in this portal renders to Microsoft Word (.docx) alongside the web view. Click the DOCX button in the page header on any individual page, or grab a page directly (e.g. ./executive-briefs/governance-os-overview.docx).

Note

PDF and EPUB exports are planned for a later phase — see the authoring roadmap.

Canon invariants

Every document in this portal respects the invariants inherited from the UIAO canon:

  • Boundary: gcc-moderate unless explicitly noted.
  • Commercial cloud exception: Amazon Connect Contact Center only.
  • Identity model: object identity only; no person identity.
  • SSOT discipline: adapters consume and emit; they never mutate SSOT.
  • Certificate anchoring: every transaction is certificate-anchored.

Provenance

All documents carry YAML frontmatter that traces back to a specific canon source in src/uiao/canon/. Drift is detected by src/uiao/tools/sync_canon.py and surfaced as canon-sync-labeled PRs.

Label Meaning
canon-derived Frontmatter generated from canon; body authored under review.
NEW (Proposed) Authored for leadership review; not yet promoted to canonical.
MISSING / UNSURE Gap against source text; requires clarification.
aspirational: true Capability is TARGET or DESIGN-ONLY per Substrate Status.

Repo location

This site is sourced from /docs/customer-documents/ in the unified UIAO monorepo. The directory tree is documented in TREE.md.

Generated under the UIAO Canonical Document Specification v1.3. Authored under pseudonym Michal Doroszewski per docs governance.

Back to top