diff --git a/docs/decisions.md b/docs/decisions.md index 846fdbe..0803c99 100644 --- a/docs/decisions.md +++ b/docs/decisions.md @@ -259,7 +259,7 @@ Their CommonMark suite exceptions are `node-model` (§The CommonMark suite check A reader panel on 2026-10-18 read the title again: seven readers across the bot, the LLM pipeline, a support agent and a product manager. Two picked a caption, two the picture alone, and three neither, each describing hover text, which ADF holds no node for. No output reached five of seven, so the -caption reading stands until `todo.md` item 121 is answered. +title still reads as the image's caption until `todo.md` item 121 is answered. ## 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 @@ -285,9 +285,10 @@ Goal 6. Valid while the audience reads a title as hover text. `adfToLosslessMarkdown` writes a `media` whose only mark is a link as `[![alt](url)](href)`, which each reader expected before seeing the options. A captioned image keeps the `!adf:caption` -directive: each reader read `![alt](url "title")` as hover text, not a caption. The caption reading -stands; a reader panel on 2026-10-18 did not settle it (§An image reads as an image only alone in its -paragraph), and `todo.md` item 121 asks the maintainer for the answer. +directive: each reader read `![alt](url "title")` as hover text, not a caption. The library's readers +still build a title as the image's caption; a reader panel on 2026-10-18 did not settle whether they +should (§An image reads as an image only alone in its paragraph), and `todo.md` item 121 asks the +maintainer for the answer. ## A linked image standing inline in portable markdown, its link to another target, is written `[alt](href) ([image](url))` diff --git a/todo.md b/todo.md index aaa32dc..9401707 100644 --- a/todo.md +++ b/todo.md @@ -68,14 +68,15 @@ of seven. ADF holds no node for hover text, so the caption is the only ADF place for the title's words. Goal 7 says lossy conversion drops form, never content. The README's portable section defines content as -what a reader sees or follows, which a hover title is not at rest. The goals do not say whether a -title is content. Earlier entries of this class: §An image reads as an image only alone in its paragraph (the +what a reader sees or follows. A hover title is seen only when the pointer rests on the picture. +The goals do not say whether a +title is content. Earlier entries on what an image's title reads as: §An image reads as an image only alone in its paragraph (the caption, 2026-10-09, 3 of 3); §A linked image is written `[![alt](url)](href)`, a captioned image as -its directive (2026-10-11, 3 of 3, reading a title as hover text); and the title that drops inside -another link, chosen by Goal 6 over Goal 7. +its directive (2026-10-11, 3 of 3, reading a title as hover text); and, inside another link, a title drops, +chosen by Goal 6 over Goal 7 (§An image reads as an image only alone in its paragraph). -Candidate entry: an image's title stays the caption of an image that stays an image, because ADF -holds no hover text and the caption keeps the title's words. This image keeps "The moon, at night" +Candidate entry: an image's title becomes its caption when the image stands alone in its paragraph, +because ADF holds no hover text and the caption keeps the title's words. This image keeps "The moon, at night" as visible text under the picture. Blocks 73: the announcement waits for this answer, since the answer may change what the package