Skip to content

Versioning policy

spec v0.5.0

The meshtrap spec (frames.yaml, mqtt.yaml, api.yaml) follows semantic versioning as a single unit, recorded in the spec changelog:

  • Patch (0.0.X): clarifications, comments, typos — no wire or API change.
  • Minor (0.X.0): backwards-compatible additions (new optional fields, new message types in reserved space).
  • Major (X.0.0): anything that changes existing wire or API behaviour.

This site shows the current spec version (derived from the changelog) as a badge on every page. Browsable frozen snapshots of past versions are not published yet; the site is structured so they can be added without rework when the spec stabilises.