Site and wiki parity
Governance for two separately maintained documentation surfaces
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 documentation pipeline validates that mapped site pages exist and metadata is current whenever the site changes. Its consolidated Azure DevOps pipeline also runs the same parity and review-age checks on the Monday parity-only schedule.
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.