Active Plan: Mintlify Docs Maintenance
Active Plan: Mintlify Docs Maintenance
Section titled “Active Plan: Mintlify Docs Maintenance”Status
Section titled “Status”This file is a lightweight maintenance plan for the current Mintlify docs structure.
It is non-normative and does not define product behavior. Normative behavior remains only in:
docs/specs/prd.mddocs/specs/json-rpc-contract.md
Inputs
Section titled “Inputs”docs/mint.jsonfor navigation structure (readnavigationas the current page list; these are Mintlify page IDs, not expected localdocs/reference/*files)docs/specs/page-ownership.mdfor the page-to-anchor traceability mapdocs/specs/prd.mdanddocs/specs/json-rpc-contract.mdfor normative anchors
Traceability Control Rules (Non-Normative Process Map)
Section titled “Traceability Control Rules (Non-Normative Process Map)”- Use
docs/specs/page-ownership.mdas the page-to-anchor map; do not maintain a parallel mapping in this file. - When
docs/mint.jsonor normative docs change, update affected rows inpage-ownership.mdin the same PR. - Keep the
Normative anchors (required)field inpage-ownership.mdcurrent for each affected page in the same PR.
Structure-Level Plan
Section titled “Structure-Level Plan”This file tracks structure/process only. Do not duplicate tuple-level semantics, per-page ownership, or verification matrices here.
- Treat
docs/mint.jsonas the nav source of truth (groups and page IDs). - Treat
docs/specs/page-ownership.mdas the only per-page ledger for owners, authoritative sources, normative anchors, and verification timestamps. - Keep this plan focused on reconciliation workflow and update triggers, not page-level inventories.
Maintenance Notes
Section titled “Maintenance Notes”- When
docs/mint.jsonadds/removes/renames groups or pages, reconcile this plan anddocs/specs/page-ownership.mdin the same PR. - When
docs/specs/prd.mdordocs/specs/json-rpc-contract.mdchanges semantics, update affected Mintlify pages and reconcile this plan plusdocs/specs/page-ownership.mdin the same PR. - Keep this plan structure-level and routing-level only; tuple-level content and verification ledgers stay in
docs/specs/page-ownership.md. - Internal support docs under
docs/specs/internal/*may guide edits but are non-normative and must not override normative sources.