INFORMATIVEACTIVE
Truth Source: Repository schemas and tests are authoritative.
Docs Information Architecture Overview
Path A — Specification Path (Implementers)
Audience: Protocol implementers, SDK authors, runtime builders Goal: Correct, complete implementation of MPLP
Recommended Order
- Architecture — L1–L4 layer model
- Core Modules — 10 module specifications
- Schemas — JSON Schema contracts
- Cross-Cutting Duties
- Golden Flows — validation scenarios
Normative Weight: High Change Sensitivity: Protocol-level
Path B — Governance Path (Contributors & Maintainers)
Audience: Project contributors, documentation maintainers, governance committee members Goal: Understand contribution rules, governance policies, and quality standards
Recommended Order
- Author Rules — Documentation contribution guidelines
- Alignment Index (Coming Soon) — Docs-to-code mapping
- Protocol Governance — MPGC policies
- Standards Mapping — External standard alignment
Normative Weight: Mixed Change Sensitivity: Governance-level
Path C — Builder Path (SDK & Runtime Users)
Audience: Developers using MPLP libraries and runtimes Goal: Build systems on top of MPLP
Recommended Order
- SDK Overview — Package structure
- Runtime Concepts — AEL / VSL / PSG
- Examples & Recipes — Practical usage
- Golden Flows — expected behavior
Normative Weight: Mixed Change Sensitivity: Implementation-level
Sidebar Organization
| Section | Content Type | Path |
|---|---|---|
| Reference | Overview, Glossary, API | /docs/index |
| Architecture | L1–L4 specification | /docs/architecture |
| Modules | 10 module specs | /docs/modules |
| Profiles | SA / MAP | /docs/profiles |
| Observability | Trace, Drift | /docs/observability |
| Golden Flows | Validation scenarios | /docs/evaluation/golden-flows/index |
| Runtime | AEL / VSL / PSG | /docs/runtime |
| SDK | Package documentation | /docs/sdk |
| Examples | Practical recipes | /docs/examples |
| Governance | MPGC, policies | /docs/governance |
| Standards | ISO, NIST, W3C mapping | /docs/standards |
This IA is structural only and does not modify any existing specification.