Introduction

The JSON Migrate standard describes an approach to Semantic Compatibility that revolves around the use of a so-called "semantic model" to both generate JSON Schema compliant schemas for each version of the model as well as migrate configurations between these schemas. A semantic model consists of an initial "base" schema and a user-defined set of migrations that describe how the data model has evolved over time. These migrations provide a single source of truth for schema generation and data migration, greatly simplifying the task of maintaining a coherent data model. In addition, the ability to migrate a given configuration to any reachable version in the semantic model on demand massively simplifies and derisks the process of making data model changes in complex, distributed systems.