Specification v1.1: clause 11 change operations, Annex E business interchange - #43
Open
ronaldtse wants to merge 1 commit into
Open
Specification v1.1: clause 11 change operations, Annex E business interchange#43ronaldtse wants to merge 1 commit into
ronaldtse wants to merge 1 commit into
Conversation
…erchange Clause 11 (Change models) gains three new subclauses and a foundational Addressing model subclause: - Addressing model: three addressing modes (identifier reference, ordinal position, text cursor range); multi-valued slot semantics; the SHOULD note that change targets carry an id register entry. - NodePosition entry; NodeInsert gains the +position attribute. - Table changes: the full family (RowInsert/Delete/Move, ColumnInsert/Delete/Move, CellUpdate/Merge/Split) with grid coordinates that account for colspan/rowspan. New TableChanges.png embedded. - Computed content: formula blocks as cells; notation via stemType and the scheme register key; evaluation/recompute out of scope. - Ordering and concurrent changes: changes are operation records; parentIdentifier carries the causal DAG; OT/CRDT/diff algorithms out of scope (same neutrality as serialization). Annex E (Application to business document interchange, informative): worked purchase-order mapping and revision-round story, no new constructs. The worked instance is the new examples/business-document in the model repo (Annex E points to it). Cover (cc-36010.adoc): edition 1.1, revdate/published-date 2026-09-07 - to be confirmed at publication. ISO copy (iso-36010.adoc): Annex E included; cover left at stage 40.00 per current fast-track status. Annex D extended: change-operations conformance row + extended test material covering business instance and change twin. Bibliography: ISO 6523, ISO 9735 added (informative, referenced from intro commerce paragraph). Submodule pin advanced to metanorma/basicdoc-models change-operations @cfe50c1 for buildability of TableChanges.png; will be updated to main in a follow-up commit after the models PR (#61) merges.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
CC 36010 v1.1: change operations + Annex E business interchange
Companion to metanorma/basicdoc-models#61
(Change operations v1.1). Together they answer two TC 154 questions
on the document:
exchanged? — clause 11 gains the whole table-change family with
grid coordinates that account for colspan/rowspan, plus a
computed-content clause covering formulas in cells.
11 gains an Ordering-and-concurrent-changes clause that states the
boundary plainly: changes are operation records; parentIdentifier
carries the causal DAG; OT/CRDT/diff algorithms are out of scope,
the same neutrality as serialization.
Clause 11 additions
modes (identifier reference, ordinal position, text cursor range);
multi-valued slot semantics; the SHOULD note that change targets
carry an
idregister entry.+positionattribute.
[[table-changes]]): the full family(
RowInsert/Delete/Move,ColumnInsert/Delete/Move,CellUpdate/Merge/Split) with grid semantics that account forcolspan/rowspan. NewTableChanges.pngembedded (from the modelrepo).
[[computed-content]]): formula blocks ascells; notation via
stemTypeand theschemeregister key;evaluation, reference resolution and recompute are out of scope.
[[ordering]]): changes areoperation records;
parentIdentifiercarries the causal DAG; howconcurrent operations transform against each other (OT, CRDT,
diff/patch) is out of scope, the same neutrality pattern as
serialization.
A relation to in-document change markup (
AmendBlock) is recorded inthe General clause.
Annex E (new, informative)
sources/sections/ae-business-interchange.adoc— worked commercialdocument (purchase order) mapping and revision-round story. The
worked instance lives alongside the model as
examples/business-document.yaml(validated byrake fixtures:yaml).Nothing in this annex adds a construct to the model — everything
shown is ordinary
BasicDocumentcontent, register entries, andchanges. This is the TC 154 positioning answer: business documents
are a first-class application of the generic base, like ISO 8601 is
generic time that commerce profiles.
Annex D extension
and the change twin.
Intro and scope positioning
sources/sections/00-intro.adocadds a paragraph on business documentinterchange and cites ISO 8601 and ISO 6523 as the element standards
this complements.
01-scope.adocadds an informative pointer toAnnex E.
Bibliography
ISO 6523 and ISO 9735 added (informative) for the intro paragraph.
Cover changes (
cc-36010.adoc):status: publishedretained.Submodule pin coordination
sources/basicdoc-modelsis advanced to the models PR branch tipcfe50c1so the newTableChanges.pngresolves in this PR's build.When models PR #61 merges, a follow-up commit will advance the pin to
the merged main SHA before the final CC 36010 v1.1 publication.
Gates
The model half (PR #61) ran
rake check,rake fixtures,rake profilesgreen. This repo's CI(
.github/workflows/generate.yml) builds both cc-36010 and iso-36010via metanorma-generate against the advanced submodule.