Rewrite the em-dashes in the specification #26

Parent

#21

What to build

Every em-dash in the specification chapters, the worked examples and the diagrams is rewritten: about 1,000 in total, 60 of them inside draw.io diagrams. Each one is rewritten by reading its sentence and choosing a comma, a colon, a full stop or parentheses. An em-dash standing alone in a table cell becomes -.

The meaning of a normative sentence never changes. Where a rewrite would change what a sentence claims, the sentence is flagged in the pull request for review rather than guessed.

A heading that loses an em-dash changes its anchor, so every link and every ADR normative: pointer to that heading is updated in the same pull request. Diagram text is edited so that the embedded draw.io source and the rendered SVG still agree. The rewritten files come off the allow list.

Acceptance criteria

• No em-dash remains in the specification chapters, examples or diagrams, and those files are off the allow list.
• npm run lint:adrs and npm run lint:links pass.
• The diagram consistency test passes, and every changed diagram still opens in draw.io.
• The diff changes punctuation and the wording around it only: no rule, field, code, number or value changes.

Blocked by

• Stop new em-dashes from entering the repository #25