Goal 5's omission-note sentence moves to the plain flavour's spellings decision
CI / gate (push) Successful in 40s
CI / publish (push) Has been cancelled

This commit is contained in:
2026-09-30 22:28:40 +02:00
parent e17e247351
commit 1df58cf33e
2 changed files with 5 additions and 5 deletions
+3 -5
View File
@@ -40,11 +40,9 @@ In priority order.
flavour's directive form carries only what CommonMark cannot hold.
5. **Lossy conversion keeps the content.** `adfToPlainMarkdown` and `plainMarkdownToAdf` drop what
plain markdown cannot hold — format, design, structure — never content: what a reader of the
rendered document sees or follows, its text, images and link targets. Content the document only
references is marked where it stood, by a note that reads as the converter's and names what was
left out. The lossy pair creates and exports; it never saves back over the document it read —
a document's identity (task, mention, media ids) survives a round trip only through the lossless
pair.
rendered document sees or follows, its text, images and link targets. The lossy pair creates and
exports; it never saves back over the document it read — a document's identity (task, mention,
media ids) survives a round trip only through the lossless pair.
6. **What happens is what the audience expects.** Where the goals leave a choice, a conversion
takes the one its audience would predict, reading the input as written.
7. **Failures are values.** Nothing throws, and `code` is a closed list — as much a contract as
+2
View File
@@ -158,6 +158,8 @@ renderer confirming each shape. Reader panels settled `error` as an error panel,
delimiter, so `は==日本語==で` (3 of 3), `==한국어==에서만` and `iPhone==専用==` (6 of 7) highlight,
the external image's two forms (6 of 7), the omission notes and a rule opening a list item
dropping (3 of 3), and a list's numbering overflowing into bullets (3 of 3, 5 of 7).
Content the document only references is marked where it stood, by a note that reads as the
converter's and names what was left out.
Reading takes other tools' spellings, since it reads their output and writes none of them.
Rejected: `~sub~` and `^sup^` (`~2~` is a strike on GitHub, so `subsup` drops), underline and colour
spellings, raw HTML (`<details>`, `<mark>`), MkDocs `!!!` and the `:::` admonition family,