Skip to content

Commit b510d0a

Browse files
committed
docs(zarr-metadata): the fragment takes this PR's number and says what breaks
Assisted-by: ClaudeCode:claude-opus-5-5
1 parent 0c2da51 commit b510d0a

2 files changed

Lines changed: 11 additions & 5 deletions

File tree

‎packages/zarr-metadata/changes/353.feature.md‎

Lines changed: 0 additions & 5 deletions
This file was deleted.
Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,11 @@
1+
**Breaking:** `must_understand: false` is refused at every extension point
2+
of an array document, codecs and storage transformers included, not only
3+
at `data_type`, `chunk_grid` and `chunk_key_encoding`: ignoring a codec
4+
gives wrong bytes as surely as ignoring a data type gives wrong values,
5+
and the spec naming only three points is read as an oversight. A document
6+
that declares a codec or a storage transformer ignorable now has a problem
7+
at `codecs.N.must_understand` or `storage_transformers.N.must_understand`,
8+
so the readers refuse it, and `to_key_value` refuses to write a model that
9+
holds one. The JSON schema `zarr_metadata.pydantic` generates for an array
10+
document says the same. A metadata field read on its own still takes
11+
`must_understand: false`.

0 commit comments

Comments
 (0)