From ca758bcde58798d0c934f31a36270f56523a74d8 Mon Sep 17 00:00:00 2001 From: Lilleman auf Larv Date: Sat, 14 Nov 2026 15:47:07 +0100 Subject: [PATCH] =?UTF-8?q?Answer=20prose=20round=201:=201=20=F0=9F=94=B4,?= =?UTF-8?q?=207=20=F0=9F=9F=A1=20(0=20misread);=20record=20the=20links=20a?= =?UTF-8?q?nd=20task-state=20panel,=20file=20the=20audience=20question?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/decisions.md | 40 +++++++++++++++++++++++++--------------- todo.md | 22 +++++++++++++++++----- 2 files changed, 42 insertions(+), 20 deletions(-) diff --git a/docs/decisions.md b/docs/decisions.md index 8603c85..3c6e48b 100644 --- a/docs/decisions.md +++ b/docs/decisions.md @@ -1300,24 +1300,34 @@ it wanted the day shown, as `!adf:date[2025-08-25]{timestamp=…}`. ## Plain text is blocks a blank line apart, with `• ` and `1.` markers and nesting indented 2026-11-14, a reader panel of 7 (export/indexing, LLM/agent, support agent, viewer/editor, bot, -product manager, engineer), then the maintainer. Goal 10. Valid while the audience of the text is +product manager, engineer), then the maintainer; a second panel of 3 (support agent, product +manager, export/indexing) for links and task state. Goal 10. Valid while the audience of the text is people reading an email. -Each reader wrote the text they expected, then picked among six shuffled candidates. All seven -expected a blank line between blocks, a hard break as one line feed and a mention as its display -text. Three picked blank lines with no markers and no indent, three picked `• ` bullets with `1.` -numbers kept and nesting indented, one picked `- ` and `1.` markers. Less than five of seven is a -missing goal, so the maintainer chose the second and worded the goal for people reading an email. +Each reader of the first panel wrote the text they expected, then picked among six shuffled +candidates. All seven expected a blank line between blocks, a hard break as one line feed and a +mention as its display text. Three picked blank lines with no markers and no indent, three picked +`• ` bullets with `1.` numbers kept and nesting indented, one picked `- ` and `1.` markers. Fewer +than five of seven is a missing goal, so the maintainer chose the `• ` bullets and worded the goal +for people reading an email. + +The second panel's readers each wrote the text they expected, then picked among four shuffled +candidates for the links and four for task state. All three picked a link's address in parentheses +after its text, with the title after the address, and `☑` and `☐` in place of the bullet. All three +had expected no title, and goal 7 counts a title as content, so every candidate kept it. `adfToPlainText` writes: -- Blocks a blank line apart, an item's blocks and a list's items a line apart. -- `• ` for a bullet list, a task list and a decision list, and `n. ` for an ordered list, counting - from its `order`. A nested list and an item's later lines are indented to the marker's width. -- A hard break as a line feed, a mention, emoji, date and status as the text they show, and marks - as the text they mark. +- Blocks a blank line apart; an item's blocks and a list's items one line feed apart. +- `• ` for a bullet list and a decision list, and `n. ` for an ordered list, counting from its + `order`. +- `☑ ` for a done task item and `☐ ` for any other, in place of the bullet. +- A nested list and an item's later lines indented to the marker's width. +- A list child that is no item, such as a task list nested in one, under the item before it. +- A hard break as a line feed, two in a row as a blank line. +- A mention, emoji, date and status as the text they show. +- A link's text, then ` (address)` or ` (address, "title")`, once after a run of text nodes sharing + the link; nothing after a link whose text is its address and that holds no title. +- Any other mark as the text it marks. - A block holding no text as nothing, with no extra blank line. -- A table as its cells written as blocks, until a plan item gives it a spelling. - -The depth and length refusals are `adfToHtml`'s: a document nesting past 500 levels, or text past -V8's longest string, indentation included. +- A table as its cells written as blocks, until item 180 gives it a spelling. diff --git a/todo.md b/todo.md index 5b9b41a..0277194 100644 --- a/todo.md +++ b/todo.md @@ -6,12 +6,13 @@ `Bar = 0.1` -`Next ID = 182` +`Next ID = 183` ## Items | ID | Release | Blocked by | Exempt | Item | L | E | I | R | S | Moves | Score | |---|---|---|---|---|---|---|---|---|---|---|---| +| 182 | 0.4.0 | | question | **Decide whether the audience names the people reading plain text, and whether goal 10 is a sub-goal of goal 6.** | 1 | 1 | 1 | 1 | 1 | 10 by 3 | 5.6 | | 180 | 0.4.0 | | | **Write a table in `adfToPlainText` as one line per row, so a CSV export or a search index reads its cells.** | 2 | 2 | 2 | 4 | 3 | 3 by 1, 6 by 3 | 4.9 | | 181 | 0.4.0 | | | **Write media, link cards, extensions and expand titles in `adfToPlainText` as the text each shows, and answer developer-community topic 41858.** | 2 | 2 | 2 | 4 | 4 | 3 by 2, 6 by 2 | 3.3 | | 141 | 0.4.0 | | decision | **Write `strike` as HTML in `adfToHtml` and read it back in `htmlToAdf`, in place of the carry element.** | 1 | 1 | 1 | 1 | 2 | 6 by 2 | 3.2 | @@ -50,11 +51,22 @@ ## Details +### 182. Decide whether the audience names the people reading plain text, and whether goal 10 is a sub-goal of goal 6. + +`## Audience` lists no one who sends notifications or emails, and goal 10 reads like a narrower case of +goal 6 (what output the audience expects), with the same signal. Two choices are the maintainer's: + +- Add the readers of an email, a notification and a search hit to `## Audience`, so goal 10's + readers are named there. +- Keep goal 10 as it is, or make it goal 6.2 and cite 6.2 in the Moves of items 180 and 181. + +Raised by the product-owner and prose reviews of the chunk that shipped `adfToPlainText`. + ### 180. Write a table in `adfToPlainText` as one line per row, so a CSV export or a search index reads its cells. A reader panel picks the cell separator, and what a header row, a merged cell and a block nested in -a cell read as. The verdict lands in `docs/decisions.md`. Until this item ships, item 179 -writes a table's cells as blocks. +a cell read as. The verdict lands in `docs/decisions.md`. Until this item ships, +`adfToPlainText` writes a table's cells as blocks. ### 181. Write media, link cards, extensions and expand titles in `adfToPlainText` as the text each shows, and answer developer-community topic 41858. @@ -64,8 +76,8 @@ For a node that shows no text, its `shownNote` names the node instead, such as ` extension's key. A reader panel picks which texts plain text keeps, and whether it writes those notes. The verdict lands in `docs/decisions.md`. -This item doesn't read item 180's table spelling, so the two land in either order. Both change item -179's call, so the second to merge may meet a conflict; neither waits for the other. +This item doesn't read item 180's table spelling, so the two land in either order. Both change +`adfToPlainText`, so the second to merge may meet a conflict; neither waits for the other. Topic 41858 asks for ADF as plain text. Answer it once item 181 ships (the maintainer, 2026-10-28).