herdr/docs/versions/README.md

14 lines
688 B
Markdown

# Versioned documentation
This directory contains immutable documentation snapshots for stable Herdr releases.
Do not edit snapshot files manually. They must match the release tag recorded in `manifest.json`. Validate them with:
```bash
node website/scripts/docs-versions.mjs check
```
Release CI creates a new snapshot from the tagged `docs/next` tree after the GitHub Release succeeds. `website/scripts/prepare-docs.mjs` renders these snapshots at `/docs/<version>/` while keeping `/docs/` on the latest stable documentation and `/docs/preview/` on unreleased work.
The historical backfill starts at v0.5.11, the first release that included the Astro/Starlight documentation site.