3
0
mirror of https://github.com/larvit/adf-codec.git synced 2026-11-12 19:58:28 +01:00

Answer prose round 1: 0 🔴, 4 🟡; say what the readers do with a title, and point the link case at its entry

This commit is contained in:
2026-10-18 12:37:04 +02:00
committed by Lillem4n
parent eaf1490580
commit 7c6315bee1
2 changed files with 12 additions and 10 deletions
+5 -4
View File
@@ -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))`
+7 -6
View File
@@ -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