Standards

Versioning

Version identity is carried by event_type + event_version (e.g. glucose.reading / 0.1).

Change policy

  • Additive changes within a minor schema revision may add optional fields with RFC notice
  • Breaking changes require a new event_version or new event_type and migration guidance
  • Deprecation windows should be documented before removing fields or enums

Release pins

Record the Git tag or SHA when vendoring schemas in OGT or applications. See Downloads and governance Versioning Policy.