From 1df58cf33e0ffd0d6fdd381df8acf0075a25e4c6 Mon Sep 17 00:00:00 2001 From: Lilleman auf Larv Date: Wed, 30 Sep 2026 22:28:40 +0200 Subject: [PATCH] Goal 5's omission-note sentence moves to the plain flavour's spellings decision --- README.md | 8 +++----- docs/decisions.md | 2 ++ 2 files changed, 5 insertions(+), 5 deletions(-) diff --git a/README.md b/README.md index bc0b91b..2620b37 100644 --- a/README.md +++ b/README.md @@ -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 diff --git a/docs/decisions.md b/docs/decisions.md index ce5be06..eb7ea66 100644 --- a/docs/decisions.md +++ b/docs/decisions.md @@ -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 (`
`, ``), MkDocs `!!!` and the `:::` admonition family,