From 7da47d7aabfd0fc150f8cfe2a4cea73b1a2c0a0e Mon Sep 17 00:00:00 2001 From: Lilleman auf Larv Date: Fri, 9 Oct 2026 10:36:21 +0200 Subject: [PATCH] Answer architecture round 4: a folded callout's title line is no paragraph, and item 56 names the bracket resolution's range --- docs/decisions.md | 5 +++-- spec/flavour.md | 4 ++-- todo.md | 4 ++-- 3 files changed, 7 insertions(+), 6 deletions(-) diff --git a/docs/decisions.md b/docs/decisions.md index 5723d36..379f736 100644 --- a/docs/decisions.md +++ b/docs/decisions.md @@ -217,8 +217,9 @@ reads as that image, with the link marking its `media`. Inside any other link, t text the link marks, and the image's URL and title drop: the panel chose this by Goal 6, which outranks Goal 7. -In `portableMarkdownToAdf`, an alert's or callout's marker line stands apart from the lines after -it, so an image alone on either reads as the image: a reader panel of the bot, the LLM pipeline and +In `portableMarkdownToAdf`, an alert's or unfolded callout's marker line stands apart from the lines +after it, and so do those after a folded callout's title line, so an image alone on either reads as +the image: a reader panel of the bot, the LLM pipeline and a support agent, 3 of 3 on 2026-10-09, expected the picture in every case, a ticked task included. A task item holds no image in Atlassian's schema, so the paragraph a task marker opens reads its image as linked alt text, the fallback two of the three named. diff --git a/spec/flavour.md b/spec/flavour.md index a7c372d..16b97d1 100644 --- a/spec/flavour.md +++ b/spec/flavour.md @@ -323,8 +323,8 @@ directive form instead. `mediaInline` carries a media `collection` + `id`, never a URL, so anywhere else an image reads as its alt text linked to its destination, the link titled by the image's title: beside other content, in a heading, a table cell or an `!adf:paragraph`, and in the paragraph a portable task -marker opens. An alert's or callout's marker line stands apart from the lines after it, so an image -alone on either reads as the image. An empty alt text reads as the destination, as an empty link text +marker opens. An alert's or unfolded callout's marker line stands apart from the lines after it, and +so do those after a folded callout's title line, so an image alone on either reads as the image. An empty alt text reads as the destination, as an empty link text does. Inside a link's text, the alt text is plain text the link marks, and the image's destination and title drop (`docs/decisions.md` §An image reads as an image only alone in its paragraph). diff --git a/todo.md b/todo.md index ef25184..994e515 100644 --- a/todo.md +++ b/todo.md @@ -333,8 +333,8 @@ functions write `pending`, `pieces`, `deactivatedBefore` and `openingSpellableLi `takeFallback` (`emit/inline-line.ts`), which writes the record the next `lineSegments` pass reads; `writeUnpaired`, `markPairings` and `markHighlights` (`inline-content.ts`), whose order changes the output; and `nestIn` (`portable/adf-to-portable-markdown.ts`), which pushes into its caller's array. -Once `Scan`'s pieces have owners, the bracket resolution, `closeBracket` through `altText`, can -leave `inline-content.ts` (about 690 lines) for a module of its own. +Once `Scan`'s pieces have owners, the bracket resolution, `linkedAlt` through `altText` with +`holdsLink`, can leave `inline-content.ts` (about 690 lines) for a module of its own. ### 76. State the files the package does not ship once, so the build, the lint ceiling and the coverage exclusions cannot drift apart.