Why docs are modeled for versioning before they are versioned

The docs tree is modeled as a single canonical version for now, but the content model is already shaped to support versioned releases later.

March 20, 2026

Versioning adds operational weight, but retrofitting versioning later adds schema debt.

Citadel keeps one visible docs tree in the current source while reserving a version field in the content model.

  • Single canonical docs tree for now
  • Version field reserved in docs sections and pages
  • No route rewrite required when versioning is introduced