Versioning Strategy

Policy

• Use semantic docs tags aligned to gameplay release tags (vX.Y.Z).
• Keep main as latest docs for active development.
• At release, run ./scripts/snapshot-docs-version.sh vX.Y.Z to archive generated source snapshots.
• Changelog pages summarize player-facing deltas; generated pages preserve source-level inventory.

What Gets Versioned

• Generated source index (src/content/docs/generated/*)
• Registry and recipe pages
• Changelog release entries
• Docs sync policy updates (if workflow changes)