spec: VERSIONING.md — Version = compatibility class, Revision = within-class edit counter

[JarbasAl]

Defines the two-field spec-header model:

• Version — the V0/V1/V2 backward-compatibility class. Unchanged by a refinement; it answers only whether the contract is compatible with the pre-spec status quo.
• Revision — a monotonic within-class edit counter, starting at 1, bumped by every PR that alters normative content; non-normative edits do not bump it. A Version change (compatibility-class change) resets Revision to 1.

Replaces the dangling "editorial revisions bump the spec's own revision number" sentence with the full definition. This resolves the ambiguity that led refinement PRs to bump Version where a Revision bump was intended.

🤖 Generated with Claude Code

[coderabbitai]

Important

Review skipped

Draft detected.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 364c1d56-34a2-4433-aacd-5e0d5162e541

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch spec/versioning-revision

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}