Documentation Migration Plan
Status: Active
Version: 1.0.0
Last updated: 2026-07-05
Objective
Migrate scattered engineering documentation into this knowledge base without duplicating bodies — federate, index, and cite.
Phases
mermaid
gantt
title Documentation migration
dateFormat YYYY-MM-DD
section Phase 1
Portal structure + templates :done, p1a, 2026-07-05, 1d
Section READMEs + platforms :done, p1b, 2026-07-05, 1d
section Phase 2
Per-module deep pages :active, p2a, 2026-07-06, 14d
Registry index sync :p2b, 2026-07-10, 7d
section Phase 3
Product repo pointer updates :p3a, 2026-07-20, 7d
Deprecate duplicate nav :p3b, 2026-07-27, 3dSource → target mapping
| Legacy source | Target | Action |
|---|---|---|
docs/development/ENGINEERING_INDEX.md | INDEX.md | Federate — keep legacy, link from INDEX |
docs/technical/TECHNICAL_INDEX.md | ARCHITECTURE/README.md | Federate |
docs/platform/adr/ | ADR/ | Migrated — legacy path retained |
Product docs/architecture/ | MODULES/ | Cite + per-module stubs |
Product AGENTS.md | PRODUCTS/ | Summarize + link |
zaixos-registry/docs/indexes/ | REFERENCE/ | Sync machine indexes |
| Certification reports | GOVERNANCE/ | Link, do not duplicate |
Rules
- No body duplication — one canonical page per topic
- Cite-only for company authority
- Templates required for new pages
- Cross-links required per STANDARDS/cross-linking.md
Related
Breadcrumbs: Home → Governance → Migration Plan