diff --git a/AGENTS.md b/AGENTS.md index bf27ab5..1ffed48 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 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 link or directive mark wrapping only such nodes is refused, but for a link around 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 7417d7e..1488e19 100644 --- a/docs/decisions.md +++ b/docs/decisions.md @@ -256,16 +256,17 @@ 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 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 link or directive mark wrapping only such nodes is refused, but for a link around 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. +to code text under this rule, without a panel, 2026-10-14; retitled by the maintainer the same day. 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 link whose text holds something besides hard breaks, -but no node that takes a link, is `unsupported-node-shape` in `losslessMarkdownToAdf`: the panel +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 diff --git a/todo.md b/todo.md index 42308f4..cc8df09 100644 --- a/todo.md +++ b/todo.md @@ -39,7 +39,6 @@ | 33 | 0.3.0 | defect | **Emit a line in time linear in its mark runs, in `adfToLosslessMarkdown` and `adfToPortableMarkdown`.** | 4 | 5 | 8 | 6 | 9 | 9 | 8.7 | | 98 | 0.3.0 | defect | **Read blank lines inside deeply nested list items in time linear in the markdown.** | 3 | 3 | 7 | 5 | 9 | 9 | 8.2 | | 102 | 0.3.0 | decision | **Place a block a portable task list refuses at its path in the returned document without replaying `splitTaskList` on stand-in nodes.** | 3 | 4 | 7 | 2 | 4 | 1 | 8.0 | -| 116 | 0.3.0 | question | **Retitle `docs/decisions.md` §A mark skips a node that cannot hold it to say only a link or directive mark wrapping only such nodes is refused.** | 1 | 1 | 1 | 2 | 3 | 6 | 5.4 | | 109 | 0.3.0 | defect | **Spell nested lists and quotes in time linear in the markdown.** | 3 | 5 | 8 | 4 | 7 | 9 | 5.3 | | 7 | 0.4.0 | decision | **Ship HTML: `adfToHtml`, `htmlToAdf`, and markdown to and from HTML composed through ADF, each call named by its flavour.** | 6 | 9 | 9 | 9 | 9 | 2, 4 | 25.8 | | 45 | 0.4.0 | | **Replace `isAdfDocument` with a reader returning `Result`.** | 2 | 3 | 4 | 6 | 8 | 1 | 25.2 | @@ -71,12 +70,12 @@ ### 73. Announce the package where someone needing an ADF converter already reads: JRACLOUD-77436, the Atlassian developer community and Stack Overflow's ADF-to-markdown questions. -Each post links the GitHub repository, the README's comparison table and a README that opens with -what the package is. Before posting, set `converter-comparison/run.sh`'s pins to each package's -latest version, `@larvit/adf-codec@0.3.0` included, and `--before` to today. Run it, then bring the -README table, its versions and its date in step with the output. We draft each post for the place it -goes; the maintainer posts them once `0.3.0` is published. Found while planning discoverability, -2026-10-04. +Lands after every other `0.3.0` item (the maintainer, 2026-10-14). Each post links the GitHub +repository, the README's comparison table and a README that opens with what the package is. Before +posting, set `converter-comparison/run.sh`'s pins to each package's latest version, +`@larvit/adf-codec@0.3.0` included, and `--before` to today. Run it, then bring the README table, +its versions and its date in step with the output. We draft each post for the place it goes; the +maintainer posts them once `0.3.0` is published. Found while planning discoverability, 2026-10-04. ### 99. Write a linked external image standing inline or in a table cell in the spelling a reader panel picks, in `adfToPortableMarkdown`. @@ -184,14 +183,6 @@ the fix. `taskOfParagraphs` keeps the original child objects. Both paired-ruling seats on 2026-10-11 named it the reason the project read worse. -### 116. Retitle `docs/decisions.md` §A mark skips a node that cannot hold it to say only a link or directive mark wrapping only such nodes is refused. - -The title says "a mark wrapping only such nodes is refused", but emphasis wrapping only a mention or -a code span reads as the plain node, as the entry's body says. Proposed title: "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", with `AGENTS.md`'s index line. Found by the prose review of item 114, -2026-10-14. - ### 109. Spell nested lists and quotes in time linear in the markdown. Each level of a nested list or quote re-indents its whole text, so the work is the depth times the