Versioning
The docs version lock-step with the platform using semver (MAJOR.MINOR.PATCH). Every page tells you exactly which platform version it was verified against.
The source of truth is achiral.ai/VERSION (currently 3.6.1). A mirror lives at blog.docs.achiral.ai/VERSION and is bumped on every release. Every page also carries reviewed: and applies_to: in its frontmatter; those values surface in the metadata band at the top of this page as Reviewed YYYY-MM-DD and Applies to vX.Y.Z.
When to consult it
Before trusting a config example or API signature, check the Reviewed date at the top of the page. If the page's Applies to version is older than your installed version by more than one minor bump, assume the signature may have shifted and re-check the API reference. Pages older than 90 days are flagged stale in our internal audit and scheduled for refresh.
How it works
A MAJOR bump is a public-contract change — API break, removed feature, or behaviour change that requires customer action. Docs are rewritten before the release goes out.
A MINOR bump is new functionality, backward-compatible. A new public doc page is required before the feature is considered shipped.
A PATCH bump is a bug fix, clarification, or typo. Affected pages get their reviewed: date updated; no new pages required unless the fix changes documented behaviour.
Reading a page's metadata
Every page's frontmatter carries the machine-readable source:
reviewed: 2026-04-20
applies_to: "3.6.1"
The <AppliesTo> component renders these as a discreet band at the top of every article.
Limits
Minor and patch releases don't always force a docs-repo VERSION bump on the same day — there's up to a 24-hour sync window. applies_to is the version a page was verified against, not a guarantee the page still holds for every earlier version back to launch. API reference pages under /docs/api/ are re-reviewed on every minor release; concept pages under /docs/concepts/ change less often and may remain accurate across several minor bumps without a re-review.
Questions about versioning policy: support@achiral.ai. The per-month changelog rollup will go live at /docs/changelog/.