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:
+25
-15
@@ -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.
|
||||
|
||||
@@ -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).
|
||||
|
||||
|
||||
Reference in New Issue
Block a user