spec conversion - #81

Open

aaronmbauman wants to merge 85 commits into

OpenGridForum:adocfrom

aaronmbauman:spec-xml-conversion

Commits on Sep 1, 2026

docs: record the ISO constraints the toolchain has to meet
aaronmbauman
committed
479415b
spec: add Metanorma ISO document skeleton
aaronmbauman
committed
d47e7a5
spec: add the OGF edition
aaronmbauman
committed
62189ca
build: add Makefile with pinned Metanorma version
aaronmbauman
committed
613e8b8
build: add lint and check targets
aaronmbauman
committed
f3fdcf1
ci: add a workflow to build the spec and attach the artifacts
aaronmbauman
committed
e16a2a6
ci: add lint and fidelity check job
aaronmbauman
committed
5045459
tools: add docx-to-adoc converter reading word/document.xml
aaronmbauman
committed
a79fb8f
tools: map Word paragraph styles to AsciiDoc constructs
aaronmbauman
committed
acaf40e
tools: convert bookmarks and REF fields to AsciiDoc anchors
aaronmbauman
committed
2e69e01
tools: convert tables to AsciiDoc table syntax
aaronmbauman
committed
022ecc0
tools: convert footnotes and extract embedded images
aaronmbauman
committed
77db857
tools: extract normalised text inventory from docx in reading order
aaronmbauman
committed
49f1e1b
tools: add fidelity checker diffing Word against built output
aaronmbauman
committed
222ea6a
tools: scope the check to clauses present in the build
aaronmbauman
committed
f5886a6
spec: move front matter boilerplate to document metadata
aaronmbauman
committed
f136659
spec: convert change history, authors, scope and terms
aaronmbauman
committed
bce4eb6
spec: convert Clauses 1-5 (Introduction, Infoset, Schema Model)
aaronmbauman
committed
49e0bf4
spec: resolve cross-references to Clauses 1-5
aaronmbauman
committed
5a91f3b
spec: convert Clauses 6-8 (Syntax Basics, Annotations, Scoping)
aaronmbauman
committed
75484b4
spec: resolve cross-references to Clauses 6-8
aaronmbauman
committed
bf25c62
spec: convert Clauses 9-11 (Processing, Representation Properties)
aaronmbauman
committed
d36d8c2
spec: resolve cross-references to Clauses 9-11
aaronmbauman
committed
3042290
spec: convert Clause 12 (Framing)
aaronmbauman
committed
a02df3e
spec: resolve cross-references to Clause 12
aaronmbauman
committed
4065c86
spec: convert Clause 13 (Simple Types)
aaronmbauman
committed
e36e922
spec: resolve cross-references to Clause 13
aaronmbauman
committed
305b7bd
spec: convert Clauses 14-17 (Sequences, Choices, Arrays, Calculated)
aaronmbauman
committed
bdeb3ff
spec: resolve cross-references to Clauses 14-17
aaronmbauman
committed
ed2904e
spec: convert Clauses 18-19 (Expression Language, Regular Expressions)
aaronmbauman
committed
3c5e6c0
spec: resolve cross-references to Clauses 18-19
aaronmbauman
committed
4009cae
spec: convert Clauses 20-29 (Conformance, References)
aaronmbauman
committed
0267410
spec: resolve cross-references to Clauses 20-29
aaronmbauman
committed
35ee61f
spec: convert Annexes A-G
aaronmbauman
committed
6116c65
spec: resolve cross-references to Annexes A-G
aaronmbauman
committed
c0a9805
tools: generate property index from semantic XML
aaronmbauman
committed
eed1e43
tools: add cross-reference link checker
aaronmbauman
committed
7703848
ci: fail the build on unresolved cross-references
aaronmbauman
committed
c6bbd4a
build: produce OGF and ISO variants from one body
aaronmbauman
committed
55284b6
build: add release target writing versioned artifacts to docs/releases
aaronmbauman
committed
67ccd11
docs: document the build, its outputs and known toolchain issues
aaronmbauman
committed
50a9f59
spec: anchor clause and property targets for cross-referencing
aaronmbauman
committed
1ade248
spec: link cross-references written as plain text
aaronmbauman
committed
b62985c
tools: verify structural invariants in the rendered document
aaronmbauman
committed
ea5ba56
build: run the conversion check separately from make check
aaronmbauman
committed
1d3e3f1
docs: describe how to edit the specification
aaronmbauman
committed
cc07aba

Commits on Sep 15, 2026

spec: keep front matter tables out of the body numbering
aaronmbauman
committed
a46ea81
spec: label cross-references as sections, not clauses
aaronmbauman
committed
2f39954
spec: close bold markup after the Infoset member name
aaronmbauman
committed
da608bb
spec: render code examples without syntax colouring
aaronmbauman
committed
73d0cc5
spec: set the escapeScheme cross-reference title in plain text
aaronmbauman
committed
5090de6
spec: anchor appendices B and F and link the reference to B
aaronmbauman
committed
dbc5db3
spec: keep the unparsing algorithm as one list
aaronmbauman
committed
dfde850
spec: mark each ordered list with its published numbering
aaronmbauman
committed
d19e191
spec: mark unordered lists with a bullet
aaronmbauman
committed
b621400
spec: nest the effective length units list under its bullet
aaronmbauman
committed
7cf0c14
spec: continue the character encoding error list at (d)
aaronmbauman
committed
ba0c104

Commits on Sep 16, 2026

spec: drop emphasis the source explicitly turns off
aaronmbauman
committed
dc4d37a
spec: set defined terms in bold italic
aaronmbauman
committed
035663e
spec: set aligned example data in monospace
aaronmbauman
committed
a358565
spec: letter the nested items in numbered lists
aaronmbauman
committed
4a57c6e
spec: indent the word character class expressions
aaronmbauman
committed
2681a80
spec: widen the property name columns
aaronmbauman
committed
8ae46b4
spec: set the body ragged right
aaronmbauman
committed
b9bf06e
spec: restore the separator suppression matrices
aaronmbauman
committed
f8c09eb
spec: keep the variable memory state table whole
aaronmbauman
committed
8bfb3ab
spec: stop the calendar pattern table splitting a symbol
aaronmbauman
committed
0eb1328
spec: colour the bit order and alignment examples
aaronmbauman
committed
5de7898
spec: colour the standard encoding bit examples
aaronmbauman
committed
e753478
spec: frame the code examples
aaronmbauman
committed
0579b69
spec: start each clause on a new page
aaronmbauman
committed
83e5d84
spec: drop the interior rules from the grammar tables
aaronmbauman
committed
70f6c0f
spec: tighten the spacing between list items
aaronmbauman
committed
8714117
spec: indent the textNumberPattern notation lines
aaronmbauman
committed
08aa434
spec: underline "Within"
aaronmbauman
committed
b50c616
spec: put the checkRange signatures on separate lines
aaronmbauman
committed
99a2c24
spec: give nested bullets their own marker
aaronmbauman
committed
4135f59
spec: set the appendix D references as a reference list
aaronmbauman
committed
9ad2ee9
spec: restore the front matter title and section labels
aaronmbauman
committed
747f2de
spec: carry the abstract in one place
aaronmbauman
committed
f3338ab
spec: drop the ISO title prefix from the OGF edition
aaronmbauman
committed
ad514f9
spec: carry the Obsoletes text in one place
aaronmbauman
committed
e436ee1
spec: name the ISO master dfdl-iso.adoc
aaronmbauman
committed
52db5a7
spec: write down the AsciiDoc conventions
aaronmbauman
committed
9c9052e
spec: number footnotes in one sequence and set table ones at the page foot
aaronmbauman
committed
1b336b3