Contributing
Documentation updates are handled in small, reviewable increments.
Workflow
- Propose the smallest useful change.
- Implement only that change.
- Review locally (
npm startandnpm run build). - Approve and commit.
- Deploy automatically via Netlify.
Commit and review model
- The repository owner is the sole committer.
- Changes are prepared step by step for review before commit.
- Keep scope tight; avoid bundling unrelated edits.
Editing guidelines
- Prefer concise pages over long narrative docs.
- Keep repository descriptions practical and up to date.
- Update this docs hub incrementally as source projects evolve.
- Use the documentation checklists in
Documentation Toolkit:Monorepo Doc Checklistfor multi-component repositories.Single-Repo Doc Checklistfor one-app repositories.
Agent-assisted sync workflow
- Use
Documentation Sync Workflowas the operating runbook. - Repository lifecycle and sync state are tracked in
docs/ops/repo-doc-sync-state.yaml. bootstrapmode is for initial/standardization passes;maintenancemode is for commit-delta updates fromlast_synced_sha.