Philosophy
We version docs when the gameplay experience or public APIs change in incompatible ways. Routine copy edits stay on the live version.
Version Types
| Version | Trigger | Storage |
|---|---|---|
current | Default branch | docs/ root |
vX.Y | Major gameplay update | versions/vX.Y/ (mirrors structure) |
legacy | Unsupported content | Archived branch or zipped export |
Release Flow
- Prepare changes under
docs/. - Once the update ships, copy the folder into
versions/vX.Y/and freeze. - Update
docs/en/reference/changelog.mdwith highlights and links. - Ensure search indexing excludes archived versions unless explicitly requested (configure Meilisearch filter).
Changelog
Use semantic headings:
## [v2.0.0] - 2025-11-21
### Added
- ...
The docs/en/reference/changelog.md file keeps the public record synchronized with in-game releases.