Introduction
This guide explains how to use thisversion, with a particular focus on
advanced workflows and the decisions involved in evolving persisted data.
For the what, the available derives, traits, types and functions, see the API reference.
The chapters below focus on decisions that arise as your data evolves. They can be read independently:
-
Adding the next schema version Evolve a working schema while preserving the meaning of existing data.
-
Adopting existing persisted data Bring unversioned data into an explicit version history.
-
Choosing how nested schemas evolve Decide whether nested schemas should have independent histories or use a fixed representation.
-
Fallible migrations Add migrations that can reject values and return errors.
-
Manually implementing conversions Map schemas to models when the derive’s field mapping is not enough.