12.5 Git as version axis
Platform-spec is versioned by commit, not by version segments in URLs.
Git as version axis
There is no /platform-spec/v0.2/... tree. The contract at commit abc123 is whatever normative text and metadata exist at abc123.
Policy: Release and versioning policy.
Stable URLs, moving prose
Section titled “Stable URLs, moving prose”- Paths like
/platform-spec/language-meta/contracts-and-effects/contracts/stay stable across releases. - Behavioral change edits the page body,
lastReviewed, ADR status, and embedded decisions, not the URL.
Rolling integration
Section titled “Rolling integration”main (or your integration branch) is the usual rolling axis for:
- Public docs site builds
- CLI
cli-stable/cli-unstablerolling releases (Downloads) - Spec freshness via
lastReviewed(Last reviewed policy)
Single normative entry
Section titled “Single normative entry”/platform-spec/ is the one normative documentation tree. Legacy trees remain bridges, not parallel law (Non-normative bridge docs).