mirror of
https://github.com/larvit/adf-codec.git
synced 2026-11-21 15:42:58 +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
|
- 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 `[](href)`, a captioned image as its directive
|
- A linked image is written `[](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
@@ -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 `[](href)`, a captioned image as its directive
|
## A linked image is written `[](href)`, a captioned image as its directive
|
||||||
|
|
||||||
|
|||||||
Reference in New Issue
Block a user