Files
XC_VM/docs/requirements.txt
Divarion_D abcb09c120 docs(ci): version the docs site per release with mike
Add a version selector to the docs and publish one snapshot per release instead
of a single rolling site, so readers can pick the docs matching their installed
version (the docs change release to release).

- mkdocs.yml: enable the Material version selector (extra.version.provider: mike,
  alias: true).
- docs/requirements.txt: add mike==2.1.3.
- pages.yml: deploy with mike, triggered by a release TAG (semver) instead of
  every push to main — publishing is tied to the release because docs/ru is only
  regenerated then. Deploys `X.Y.Z` + the `latest` alias to the gh-pages branch
  and sets latest as default. workflow_dispatch takes an explicit version.
- updates_checklist.md: note the tag-triggered versioned publish.

One-time setup (GitHub UI): Settings → Pages → Deploy from a branch → gh-pages.
2026-08-28 22:36:14 +03:00

10 lines
441 B
Plaintext

# MkDocs site BUILD toolchain — used by CI (.github/workflows/pages.yml) and by
# `make docs-build` / `docs-serve`. Translation is a separate, local-only step;
# its dependencies live in tools/docs/requirements.txt.
mkdocs-material==9.7.7
mkdocs-static-i18n==1.3.1
# Versioned docs: one published snapshot per release tag, with a `latest` alias
# and the version selector in the Material header (extra.version in mkdocs.yml).
mike==2.1.3