summaryrefslogtreecommitdiffhomepage
path: root/README.md
diff options
context:
space:
mode:
authorRalph Amissah <ralph.amissah@gmail.com>2026-09-25 22:28:50 -0400
committerRalph Amissah <ralph.amissah@gmail.com>2026-10-03 21:50:59 -0400
commit5a5036e53aa18afa61d6e475336cd96c115dac00 (patch)
tree669a9190703b6833591311c73f4646a123c11dc3 /README.md
parent.ocda.db specified & the two serialisations agree (diff)
derived values that the model left unstated
The model says nothing about an object's identifier or its anchor, and both are derived: the identifier is the ocn where there is one, the anchor is the segment name. The .ssp omits each where it can be worked out; the .ocda.db states both on every row. This is existing behaviour, not a new rule. Spine's own .ssp reader has always filled both in, which is why the database carries them: the database is written from the .ssp read straight back. It should have been written down first. Two readers written independently from these documents disagreed for want of it, on nearly every object, and nothing short of comparing whole models showed it. ocda-model.md gains 3.1 the identifier, 7.1 the anchor and 9 derived values, with the loading rule in a table; "what the model does not hold" becomes 10. The two format specifications gain what a reader needs and did not have: - the .ssp's property table now says what the absent value is, not only when it is written; - the .ocda.db gains 3.2.1, the metadata key prefix that carries what the .ssp puts in four blocks, which a reader must strip to give one model from either file, and the note that a value here may carry whitespace the text form cannot represent; - 3.3 gains the element types of each JSON column and a warning to parse rather than scan: the encoder writes "/" as "\/" and every document in the reference collection has a heading containing one; - 4.1 names the three places the two files are not symmetric, including translation.ocn_aligned, which a .ssp cannot hold because it is one language, and which a reader should keep out of the document model so that nothing built on the model can tell which file it was given. (assisted by Claude-Code)
Diffstat (limited to 'README.md')
0 files changed, 0 insertions, 0 deletions