Specification
ChangeSpec versions
Versioned specification documents. v1.1 is the current stable release. Each version has a permanent URL and remains available for reference.
Available versions
| Version | Status | Release date | Document |
|---|---|---|---|
| v1.1 | Current | 2026-05-12 | Read specification → |
| v1.0 | Stable | 2026-04-16 | Read specification → |
Versioning policy
Each version of the ChangeSpec specification receives a permanent URL at /spec/vX.Y/. Once published, the document at that URL does not change except for errata. Errata are noted in the document with a dated annotation.
Patch releases (1.0.1): clarifications only. No field additions, removals, or semantic changes. The document at /spec/v1.0/ is updated in place with an errata notice.
Minor releases (1.1, 1.2): may add optional fields, may extend enum values. Existing values are not removed or redefined. Published at a new URL (/spec/v1.1/). The 1.0 document remains unchanged.
Major releases (2.0): may change required fields or redefine semantics. Require a formal deprecation period of at least 12 months before the prior major version is marked deprecated.
Source and issues
The specification source is maintained at github.com/changespec/spec. Proposed changes are submitted as pull requests against the main branch. Major changes require a Specification Extension Proposal (SEP). See how to contribute.