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:
+5
-4
@@ -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 `[](href)`, which
|
||||
each reader expected before seeing the options. A captioned image keeps the `!adf:caption`
|
||||
directive: each reader read `` 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 `` 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))`
|
||||
|
||||
|
||||
@@ -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 `[](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
|
||||
|
||||
Reference in New Issue
Block a user