diff --git a/AGENTS.md b/AGENTS.md index 1ffed48..85c7b98 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -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 `[![alt](url)](href)`, a captioned image as its directive - Ids stay site-local - Portable task ids come from position diff --git a/docs/decisions.md b/docs/decisions.md index 1488e19..03178a6 100644 --- a/docs/decisions.md +++ b/docs/decisions.md @@ -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 `[![alt](url)](href)`, a captioned image as its directive