wildwood / manualPUBLISHED

THE MANUAL / EN

Schema generations

Prepare new interpretations without rewriting source history.

Bump the version

A generation identifies how source bytes are parsed and indexed. This demo's generation 2 adds an audience field with a safe default. Existing Markdown does not need that field.

Switch between generation 1 and 2 above. Both read the same snapshot. The second generation prepares its own projections automatically; the first remains available.

Defaults are not arbitrary migrations

A version bump cannot invent missing required information. Invalid content fails preparation and does not move a branch. Supply a default, a deterministic transformation, or update the source data when the schema requires it.