Context
Define how docs stay fresh as upstream sources evolve. This covers change detection, sync automation, and freshness ownership.
Questions to answer
- Upstream change detection: How do we know when
.sources/ submodules have content that invalidates our docs? (Submodule bump PRs? Dependabot-style automation?)
- Sync automation: Which pages should be auto-synced vs. hand-written? (Currently: Motoko pages synced, everything else hand-written)
- Freshness ownership: Who owns keeping each section current? (Define in CODEOWNERS + section-level ownership docs)
- Review cadence: How often should pages be spot-checked against upstream? (Propose a schedule)
Depends on
Output
A decision recorded in .docs-plan/decisions.md and/or a new CONTRIBUTING.md section on content lifecycle.
Context
Define how docs stay fresh as upstream sources evolve. This covers change detection, sync automation, and freshness ownership.
Questions to answer
.sources/submodules have content that invalidates our docs? (Submodule bump PRs? Dependabot-style automation?)Depends on
Output
A decision recorded in
.docs-plan/decisions.mdand/or a newCONTRIBUTING.mdsection on content lifecycle.