From 20a5d4f0c6029fcba220f04781622d20f45327a6 Mon Sep 17 00:00:00 2001
From: Lilleman auf Larv <lilleman@larvit.se>
Date: Wed, 4 Nov 2026 13:45:29 +0100
Subject: [PATCH] =?UTF-8?q?Answer=20prose=20round=201:=200=20=F0=9F=94=B4,?=
 =?UTF-8?q?=208=20=F0=9F=9F=A1=20(0=20misread);=20correct=20the=20panel=20?=
 =?UTF-8?q?count,=20say=20which=20node=20rides=20the=20carry,=20list=20the?=
 =?UTF-8?q?=20new=20nodes'=20data-*=20attributes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 CHANGELOG.md      | 19 ++++++++++---------
 docs/decisions.md | 21 +++++++++++----------
 2 files changed, 21 insertions(+), 19 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 06acf91..bc86b51 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -8,19 +8,20 @@
   to or from markdown, wrappers and forks aside; its second table lists other ecosystems'
   libraries and Atlassian's own paths.
 - `adfToHtml` writes ADF as HTML: paragraphs, headings, lists, quotes, code blocks, rules, hard
-  breaks, a centered, uncaptioned external image holding no attribute but its URL and alt, an
-  emoji, a status, a date and a card holding only a URL (`<span class="adf-emoji">`, `<span class="adf-status">`,
-  `<time class="adf-date">`, `<a class="adf-inline-card">`), and `em`, `strong`, `code` and links as
-  their elements. A paragraph, heading, quote, list, list item, code block or
-  rule writes its other attributes as `data-*` attributes, `localId` as `data-local-id`. Every other
-  node is an element of class `adf-carry` holding the node's JSON in `data-adf` and showing its
+  breaks, a centered, uncaptioned external image holding no attribute but its URL and alt, and
+  `em`, `strong`, `code` and links as their elements. An unmarked emoji, status, date and card
+  holding a URL and no `data` are `<span class="adf-emoji">`, `<span class="adf-status">`,
+  `<time class="adf-date">` and `<a class="adf-inline-card">`. A paragraph, heading, quote, list,
+  list item, code block, rule, emoji, status, date or card writes its other attributes as `data-*`
+  attributes, `localId` as `data-local-id`. Every other node is an element of class `adf-carry` holding the node's JSON in `data-adf` and showing its
   content, links included. Every URL is written as the ADF holds it,
   `javascript:` included: sanitize HTML from an author you do not trust before showing it.
 - `htmlToAdf` reads `adfToHtml`'s HTML back to the document it came from, a carry element from its
-  `data-adf`, and those elements. It reads that HTML as a browser's `innerHTML` writes it too (a raw `"` in text,
+  `data-adf`. It reads that HTML as a browser's `innerHTML` writes it too (a raw `"` in text,
   `&nbsp;`, a raw `<` or `>` in an attribute value) and as a form post sends it (`\r\n` for each
-  line feed). It refuses any other HTML, including an edit to what a carry element shows, with the
-  codes README §The calls lists.
+  line feed). An edit to an emoji's or status's text becomes its `text`; an edit to a date's or a
+  card's text alone is refused. It refuses any other HTML, including an edit to what a carry element
+  shows, with the codes README §The calls lists.
 - **Breaking:** `losslessMarkdownToAdf` gives a `date`, `emoji`, `inlineCard`, `mention`, `status`
   or `mediaInline` only the marks Atlassian's schema lets it hold: `**!adf:mention[@A]{id=…}**` now
   reads as a plain mention. A link or directive mark around only nodes that cannot take it is
diff --git a/docs/decisions.md b/docs/decisions.md
index 7bafa82..7087899 100644
--- a/docs/decisions.md
+++ b/docs/decisions.md
@@ -401,8 +401,8 @@ for HTML+, its Rovo MCP server's HTML for agents; a published spec reopens the g
 The HTML dialect mirrors the markdown flavour: semantic elements, stable `adf-*` classes, `data-*`
 for what HTML cannot express, text always escaped. No stylesheet ships.
 
-The spellings, `spec/html.md`, are four writer panels' (2026-10-23 and -24), each of a product
-manager, an engineer and a support agent. The first picked each of these 3 of 3:
+The spellings, `spec/html.md`, are five writer panels' (2026-10-23, -24 and 2026-11-04), each of a
+product manager, an engineer and a support agent. The first picked each of these 3 of 3:
 
 - an image standing alone as `<p><img …></p>`, over `<figure>` and a bare `<img>`;
 - a list item's first paragraph bare, `<li>Bolt</li>`, over `<li><p>Bolt</p></li>`;
@@ -442,12 +442,12 @@ it joins the second panel's `<a>` to that portable spelling.
 Inside a carry element, a card a link marks links to the link's target, and shows its own URL as its
 text where it has one, so both stay. A card showing only its name keeps its URL in `data-adf` alone.
 Atlassian's schema gives no card a link mark, so only a hand-built document meets this;
-`todo.md` item 133 ends it for a card holding `data` or a link mark, in 0.3.0. Recorded 2026-10-24
+`todo.md` item 133 ends both, in 0.3.0, by writing such cards as their own element. Recorded 2026-10-24
 without a panel of its own: it puts the second panel's `<a>` around the text a card shows.
 
 A fifth panel (2026-11-04, three readers in the same roles, then four more for what the first three
-split on) picked how an emoji, status, date and inline card are written, the nodes the carry held.
-The first three picked each of these 3 of 3:
+split on) was asked how to write a mention, emoji, status, date and inline card, which until then
+rode the carry. The first three picked each of these 3 of 3:
 
 - an emoji as `<span class="adf-emoji" data-id="1f389" data-short-name=":tada:">🎉</span>`, its text
   the content, over an `<img>`;
@@ -457,11 +457,12 @@ The first three picked each of these 3 of 3:
 
 Seven readers picked a date as
 `<time class="adf-date" datetime="2025-08-25" data-timestamp="1756080000000">2025-08-25</time>`,
-5 of 7: the day for people, the exact timestamp for scripts. Two splits stay open and ride the carry,
-`todo.md` item 133: a mention's `data-id`, `data-access-level` and `data-user-type` drew 4 of 7, over
+5 of 7: the day for people, the exact timestamp for scripts. Two questions stayed split, so a
+mention and a card holding `data` ride the carry until the maintainer settles them, `todo.md` item
+133: a mention's `data-id`, `data-access-level` and `data-user-type` drew 4 of 7, over
 `data-mention-id` 2 and `data-user-id` 1; a card holding `data` and no URL drew `<a … href data-data>`
-3, `<a … data-card>` 2 and `<span … data-data>` 2. The link-marked card's spelling hangs on that
-one. So a card holding `data` or a mark rides the carry too.
+3, `<a … data-card>` 2 and `<span … data-data>` 2. A card a link marks waits on the second answer,
+since its name-only form is that card, so it rides the carry too.
 
 ## `htmlToAdf` also reads the dialect as a browser serializes it
 
@@ -898,7 +899,7 @@ adds scheme filtering.
 
 `adfToHtml` writes every URL exactly as the ADF holds it, escaped as every attribute value is,
 `javascript:`, `vbscript:`, `file:` and `data:` included. That covers a link's `href`, an image's
-`src`, and the `href` of each link the carry element shows: a carried node's link mark, a card's
+`src`, a card's `href`, and the `href` of each link the carry element shows: a carried node's link mark, a card's
 `url` or `data.url`, and an external image's `url`. The markdown writers don't filter schemes
 either.