mirror of
https://github.com/larvit/adf-codec.git
synced 2026-11-13 04:08:29 +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:
@@ -28,7 +28,7 @@ In `docs/decisions.md`:
|
||||
- Tables
|
||||
- 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
|
||||
- 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 `[](href)`, a captioned image as its directive
|
||||
- Ids stay site-local
|
||||
- Portable task ids come from position
|
||||
|
||||
+13
-12
@@ -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.
|
||||
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
|
||||
3 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.
|
||||
2026-10-14, two reader panels of the viewer/editor app, the LLM pipeline and a support agent, 3 of 3
|
||||
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,
|
||||
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
|
||||
`code`, `link` and `annotation`. So `**Ping !adf:mention[@A]{id=x} now**` reads as bold text around a plain
|
||||
mention, and ``**`npm ci`**`` as plain code. A directive mark wrapping only such nodes, and a link
|
||||
whose text holds something besides hard breaks but no node that takes a link, is
|
||||
`unsupported-node-shape` in `losslessMarkdownToAdf`: the panel
|
||||
refused to have `[!adf:status[Done]{color=green}](/u)` read as `/u` linked beside the status. A link
|
||||
text of hard breaks alone still reads as its destination, then the breaks (§An image reads as an
|
||||
image only alone in its paragraph). `adfToLosslessMarkdown` writes a node holding a mark its type
|
||||
does not take as `!adf:carry`, so the round-trip holds.
|
||||
`code`, `link` and `annotation`. So `**Ping !adf:mention[@A]{id=x} now**` reads as bold text around
|
||||
a plain mention, and ``**`npm ci`**`` as plain code. A directive mark wrapping only nodes that take
|
||||
none of its type is `unsupported-node-shape` in `losslessMarkdownToAdf`. So is a link whose text
|
||||
holds something besides hard breaks but no node that takes a link: the panel refused to have
|
||||
`[!adf:status[Done]{color=green}](/u)` read as `/u` linked beside the status. A link text of hard
|
||||
breaks alone still reads as its destination, then the breaks (§An image reads as an image only alone
|
||||
in its paragraph). `adfToLosslessMarkdown` writes a node holding a mark its type does not take as
|
||||
`!adf:carry`, so the round-trip holds.
|
||||
|
||||
## A linked image is written `[](href)`, a captioned image as its directive
|
||||
|
||||
|
||||
Reference in New Issue
Block a user