3
0
mirror of https://github.com/larvit/adf-codec.git synced 2026-11-20 23:25:43 +01:00

Answer prose round 1: 0 🔴, 1 🟡; scope the hard-break exception to the CommonMark link, split the refusal sentence, say who kept the directive refusal

This commit is contained in:
2026-10-14 22:07:30 +02:00
committed by Lillem4n
parent 492a7fa828
commit 251c8193e6
2 changed files with 14 additions and 13 deletions
+1 -1
View File
@@ -28,7 +28,7 @@ In `docs/decisions.md`:
- Tables - Tables
- Links - Links
- An image reads as an image only alone in its paragraph, else as its alt text linked; a link text of hard breaks alone reads as its destination, then the breaks - An image reads as an image only alone in its paragraph, else as its alt text linked; a link text of hard breaks alone reads as its destination, then the breaks
- A mark skips a node that cannot hold it, and a link or directive mark wrapping only such nodes is refused, but for a link around hard breaks alone - A mark skips a node that cannot hold it, and a directive mark wrapping only such nodes is refused, as is a `[text](url)` link unless its text is hard breaks alone
- A linked image is written `[![alt](url)](href)`, a captioned image as its directive - A linked image is written `[![alt](url)](href)`, a captioned image as its directive
- Ids stay site-local - Ids stay site-local
- Portable task ids come from position - Portable task ids come from position
+13 -12
View File
@@ -256,21 +256,22 @@ The same panel confirmed the other readings on 2026-10-09: a title as the captio
text as linked alt text, and an empty link text as its URL, each 3 of 3; `[]()` as nothing, 5 of 7. text as linked alt text, and an empty link text as its URL, each 3 of 3; `[]()` as nothing, 5 of 7.
Their CommonMark suite exceptions are `node-model` (§The CommonMark suite checks three ways). Their CommonMark suite exceptions are `node-model` (§The CommonMark suite checks three ways).
## A mark skips a node that cannot hold it, and a link or directive mark wrapping only such nodes is refused, but for a link around hard breaks alone ## A mark skips a node that cannot hold it, and a directive mark wrapping only such nodes is refused, as is a `[text](url)` link unless its text is hard breaks alone
2026-10-14, two reader panels of the viewer/editor app, the LLM pipeline and a support agent, 3 of 2026-10-14, two reader panels of the viewer/editor app, the LLM pipeline and a support agent, 3 of 3
3 each. Goals 1, 4 and 6. Valid while Atlassian's schema withholds marks from inline nodes. Extended each. Goals 1, 4 and 6. Valid while Atlassian's schema withholds marks from inline nodes. Extended
to code text under this rule, without a panel, 2026-10-14; retitled by the maintainer the same day. to code text under this rule, without a panel, 2026-10-14; retitled by the maintainer the same day,
keeping the directive-mark refusal the old title held.
A mark spelling skips a node that takes none of its type, code text included, which takes only A mark spelling skips a node that takes none of its type, code text included, which takes only
`code`, `link` and `annotation`. So `**Ping !adf:mention[@A]{id=x} now**` reads as bold text around a plain `code`, `link` and `annotation`. So `**Ping !adf:mention[@A]{id=x} now**` reads as bold text around
mention, and ``**`npm ci`**`` as plain code. A directive mark wrapping only such nodes, and a link a plain mention, and ``**`npm ci`**`` as plain code. A directive mark wrapping only nodes that take
whose text holds something besides hard breaks but no node that takes a link, is none of its type is `unsupported-node-shape` in `losslessMarkdownToAdf`. So is a link whose text
`unsupported-node-shape` in `losslessMarkdownToAdf`: the panel holds something besides hard breaks but no node that takes a link: the panel refused to have
refused to have `[!adf:status[Done]{color=green}](/u)` read as `/u` linked beside the status. A link `[!adf:status[Done]{color=green}](/u)` read as `/u` linked beside the status. A link text of hard
text of hard breaks alone still reads as its destination, then the breaks (§An image reads as an breaks alone still reads as its destination, then the breaks (§An image reads as an image only alone
image only alone in its paragraph). `adfToLosslessMarkdown` writes a node holding a mark its type in its paragraph). `adfToLosslessMarkdown` writes a node holding a mark its type does not take as
does not take as `!adf:carry`, so the round-trip holds. `!adf:carry`, so the round-trip holds.
## A linked image is written `[![alt](url)](href)`, a captioned image as its directive ## A linked image is written `[![alt](url)](href)`, a captioned image as its directive