Skip to content

infra: content lifecycle strategy #120

@marc0olo

Description

@marc0olo

Context

Define how docs stay fresh as upstream sources evolve. This covers change detection, sync automation, and freshness ownership.

Questions to answer

  1. Upstream change detection: How do we know when .sources/ submodules have content that invalidates our docs? (Submodule bump PRs? Dependabot-style automation?)
  2. Sync automation: Which pages should be auto-synced vs. hand-written? (Currently: Motoko pages synced, everything else hand-written)
  3. Freshness ownership: Who owns keeping each section current? (Define in CODEOWNERS + section-level ownership docs)
  4. 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.

Metadata

Metadata

Assignees

No one assigned

    Labels

    enhancementNew feature or request

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions