1# @the_library/canonical-schemas Governance
2
3## Who may propose changes
4
5Any contributor to the The World Library project may open a PR. All PRs that touch
6`standards/`, `definitions/canonical/`, or `types/` require consensus from
7all core maintainers before merge.
8
9## Proposing a new standard
10
11See §6.1 of canonical_schemas_package_spec.md. Short summary:
121. Open a PR against canonical-schemas adding the JSON definition to `standards/`.
132. Open a coordinated PR against standard-adapters adding the implementation.
143. Both PRs must be reviewed and merged together.
15
16## Frozen fields
17
18Once a standard definition ships in a released version, the following fields
19are frozen and may never be changed: `id`, `props[].name`, `props[].type`,
20`props[].checkDigit.algorithm`, `uriScheme` template variable names.
21Changes to frozen fields require a major version bump and a migration guide.
22
23## Version policy
24
25See §6.4 of canonical_schemas_package_spec.md.
26
27| Bump | Triggers |
28|---|---|
29| **Patch** `x.y.Z` | Typos in labels or descriptions; translation additions or corrections; governance doc edits. |
30| **Minor** `x.Y.z` | New standard definition file; new `externalApis[].id` entry; new canonical model prop or enum value. Requires coordinated minor bump on `@the_library/standard-adapters`. |
31| **Major** `X.y.z` | Any change to a frozen field; removal of a standard definition; propId reassignment. |
32