Site and wiki parity
The TauGrid documentation site and GitHub Wiki are both maintained as complete surfaces. They are edited separately, so semantic parity is a human ownership responsibility rather than an automated synchronization claim.
site/data/wiki-parity.toml records:
- The maintained site page and wiki counterpart.
- The owning team.
- Current maturity.
- Last joint review date.
The GitHub documentation validation and Pages deployment pipelines validate that
mapped site pages exist and parity metadata is structurally valid without
blocking on review age. The consolidated Azure DevOps pipeline additionally
enforces review age on the Monday parity-only schedule. Local make -C site check
also enforces the 90-day review-age limit by default.
When user-facing behavior or maturity changes:
- Update the versioned site page.
- Update the corresponding wiki page.
- Review both as one documentation change.
- Refresh the parity manifest review date.
The checks detect stale ownership and missing mappings; confirm that two independently edited pages say the same thing by reviewing both together, as in step 3 above.