3
0
mirror of https://github.com/larvit/adf-codec.git synced 2026-11-18 22:25:44 +01:00

Answer prose round 1: 1 🔴, 7 🟡 (0 misread); record the links and task-state panel, file the audience question

This commit is contained in:
2026-11-14 15:47:07 +01:00
committed by Lillem4n
parent f2808f0c9a
commit ca758bcde5
2 changed files with 42 additions and 20 deletions
+25 -15
View File
@@ -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.
+17 -5
View File
@@ -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).