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-latestrolling 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).