Widen description fields to union type

s-adamantine · web-flow · commit aab9093fe97f · 2026-04-07T22:36:06.000+02:00
Clarified the impact of the schema change on existing records.
diff --git a/.changeset/description-union-type.md b/.changeset/description-union-type.md
@@ -4,4 +4,4 @@
 
 Widen description fields on activity, collection, and attachment from a bare Leaflet ref to a union of inline descriptionString and Leaflet linearDocument, with a shared def in org.hypercerts.defs.
 
-This is technically a breaking schema change (ref → union), but not breaking in practice: all published records already include a `$type` discriminator on the description object, so existing data validates against the union without modification.
+This is technically a breaking schema change (ref → union), but not breaking for most published records, as they already include a `$type` discriminator on the description object, so existing data validates against the union without modification.

Original file line number	Diff line number	Diff line change
`@@ -4,4 +4,4 @@`
`4`	`4`
`5`	`5`	`Widen description fields on activity, collection, and attachment from a bare Leaflet ref to a union of inline descriptionString and Leaflet linearDocument, with a shared def in org.hypercerts.defs.`
`6`	`6`
`7`		-This is technically a breaking schema change (ref → union), but not breaking in practice: all published records already include a `$type` discriminator on the description object, so existing data validates against the union without modification.
	`7`	+This is technically a breaking schema change (ref → union), but not breaking for most published records, as they already include a `$type` discriminator on the description object, so existing data validates against the union without modification.