3
0
mirror of https://github.com/larvit/adf-codec.git synced 2026-11-20 23:25:43 +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 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, 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 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 ## 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 `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` 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 directive: each reader read `![alt](url "title")` as hover text, not a caption. The library's readers
stands; a reader panel on 2026-10-18 did not settle it (§An image reads as an image only alone in its still build a title as the image's caption; a reader panel on 2026-10-18 did not settle whether they
paragraph), and `todo.md` item 121 asks the maintainer for the answer. 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))` ## 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 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 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 what a reader sees or follows. A hover title is seen only when the pointer rests on the picture.
title is content. Earlier entries of this class: §An image reads as an image only alone in its paragraph (the 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 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 its directive (2026-10-11, 3 of 3, reading a title as hover text); and, inside another link, a title drops,
another link, chosen by Goal 6 over Goal 7. 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 Candidate entry: an image's title becomes its caption when the image stands alone in its paragraph,
holds no hover text and the caption keeps the title's words. This image keeps "The moon, at night" 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. as visible text under the picture.
Blocks 73: the announcement waits for this answer, since the answer may change what the package Blocks 73: the announcement waits for this answer, since the answer may change what the package