Knowledge Portal · engineering documentation

Skip to content

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, 3d

Source → target mapping

Legacy sourceTargetAction
docs/development/ENGINEERING_INDEX.mdINDEX.mdFederate — keep legacy, link from INDEX
docs/technical/TECHNICAL_INDEX.mdARCHITECTURE/README.mdFederate
docs/platform/adr/ADR/Migrated — legacy path retained
Product docs/architecture/MODULES/Cite + per-module stubs
Product AGENTS.mdPRODUCTS/Summarize + link
zaixos-registry/docs/indexes/REFERENCE/Sync machine indexes
Certification reportsGOVERNANCE/Link, do not duplicate

Rules

  1. No body duplication — one canonical page per topic
  2. Cite-only for company authority
  3. Templates required for new pages
  4. Cross-links required per STANDARDS/cross-linking.md

Breadcrumbs: Home → Governance → Migration Plan

ZAIXOS Knowledge Portal — public engineering docs at /docs · Staff operations at /admin