mirror of
https://github.com/larvit/adf-codec.git
synced 2026-11-19 14:45:44 +01:00
Answer prose round 1: 0 🔴, 5 🟡 (0 misread); the split items' details name what the call refuses, writes and leaves to the panels
This commit is contained in:
@@ -12,7 +12,7 @@
|
|||||||
|
|
||||||
| ID | Release | Blocked by | Exempt | Item | L | E | I | R | S | Moves | Score |
|
| ID | Release | Blocked by | Exempt | Item | L | E | I | R | S | Moves | Score |
|
||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
|
|---|---|---|---|---|---|---|---|---|---|---|---|
|
||||||
| 179 | 0.4.0 | | | **Ship `adfToPlainText`, writing a document's text with its blocks parted by blank lines, under a README goal for plain text.** | 2 | 2 | 2 | 4 | 5 | 3 by 4, 6 by 2 | 3.7 |
|
| 179 | 0.4.0 | | | **Ship `adfToPlainText`, writing a document's text with no markup, under a README goal for plain text.** | 2 | 2 | 2 | 4 | 5 | 3 by 4, 6 by 2 | 3.7 |
|
||||||
| 180 | 0.4.0 | 179 | | **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 | 6.1 |
|
| 180 | 0.4.0 | 179 | | **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 | 6.1 |
|
||||||
| 181 | 0.4.0 | 179, 180 | | **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 | 4.1 |
|
| 181 | 0.4.0 | 179, 180 | | **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 | 4.1 |
|
||||||
| 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 | 4.0 |
|
| 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 | 4.0 |
|
||||||
@@ -51,38 +51,40 @@
|
|||||||
|
|
||||||
## Details
|
## Details
|
||||||
|
|
||||||
### 179. Ship `adfToPlainText`, writing a document's text with its blocks parted by blank lines, under a README goal for plain text.
|
### 179. Ship `adfToPlainText`, writing a document's text with no markup, under a README goal for plain text.
|
||||||
|
|
||||||
Asked on the Atlassian developer community for search indexing, notifications, emails and CSV
|
Asked on the Atlassian developer community for search indexing, notifications, emails and CSV
|
||||||
exports, where markdown's markers are noise. Add the goal to the README's `## Goals` in the same
|
exports, where markdown's markers are noise. Add the goal to the README's `## Goals` in the same
|
||||||
change. Its wording and rank among the goals are the maintainer's to approve in the PR.
|
change. Its wording and rank among the goals are the maintainer's to approve in the PR. The
|
||||||
|
maintainer chose 0.4.0 for it, to ship what exists first.
|
||||||
|
|
||||||
The call takes an `AdfDocument` and returns `Result<string>`, refusing as `adfToHtml` does. It is
|
The call takes an `AdfDocument` and returns `Result<string>`. It refuses what `adfToHtml` refuses,
|
||||||
one-way, with no reader, so goal 1's round-trip doesn't bind it. Goal 7 does: it drops markup,
|
with the same codes: `engine-limit`, `not-an-adf-document`, `unsupported-document-version`,
|
||||||
never content. A node writes its text, and a container its children. A hard break is a newline. A
|
`unsupported-nesting-depth` and `unsupported-node-shape`. It has no reader, so goal 1's
|
||||||
mention is `@Display Name`, as `src/adf/shown-text.ts` shows it, never an account id. A node of an
|
losslessness can't apply, but it still returns a result and never throws. Goal 7 applies: the call
|
||||||
unknown type writes the text it holds, so no content is lost before items 180 and 181 refine the
|
drops markup, never content. A node writes its text, and a container its children. A hard break is
|
||||||
nodes.
|
a newline. A mention writes `@Display Name` from its `text`, as `src/adf/shown-text.ts` does, which
|
||||||
|
falls back to `@<id>` only where the mention has no text. A node of an unknown type writes the text
|
||||||
|
it holds, so no content is lost before items 180 and 181 refine the nodes.
|
||||||
|
|
||||||
A reader panel (`AGENTS.md`, "Ask, don't guess") picks how blocks part and how a list's items read:
|
A reader panel (`AGENTS.md`, "Ask, don't guess") picks how blocks part and how a list's items read:
|
||||||
markers, indentation or numbers. The verdict lands in `docs/decisions.md`. The maintainer,
|
markers, indentation or numbers. The verdict lands in `docs/decisions.md`.
|
||||||
2026-10-28: ship what exists first, so this waits for 0.4.0.
|
|
||||||
|
|
||||||
### 180. Write a table in `adfToPlainText` as one line per row, so a CSV export or a search index reads its cells.
|
### 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 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, item 179 writes a
|
a cell read as. The verdict lands in `docs/decisions.md`. Until this item ships, item 179
|
||||||
table's cells as blocks.
|
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.
|
### 181. Write media, link cards, extensions and expand titles in `adfToPlainText` as the text each shows, and answer developer-community topic 41858.
|
||||||
|
|
||||||
`src/adf/shown-text.ts` already holds the text each of these shows in portable markdown and HTML:
|
`src/adf/shown-text.ts` already holds what each of these shows in portable markdown and HTML: an
|
||||||
an image's alt text or its URL, a card's URL, an extension's key, an expand's title. A reader panel
|
image's alt text or URL, a card's URL or `data.name`, an extension's `text` and an expand's title.
|
||||||
picks which of them plain text keeps, and whether a note such as `[image]` stands in for a node
|
For a node that shows no text, its `shownNote` names the node instead, such as `image` or an
|
||||||
that shows no text. The verdict lands in `docs/decisions.md`.
|
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`.
|
||||||
|
|
||||||
Once it ships, answer developer-community topic 41858, which asks for ADF as plain text (the
|
Topic 41858 asks for ADF as plain text. Answer it once item 181 ships (the maintainer, 2026-10-28).
|
||||||
maintainer, 2026-10-28).
|
|
||||||
|
|
||||||
### 141. Write `strike` as HTML in `adfToHtml` and read it back in `htmlToAdf`, in place of the carry element.
|
### 141. Write `strike` as HTML in `adfToHtml` and read it back in `htmlToAdf`, in place of the carry element.
|
||||||
|
|
||||||
|
|||||||
Reference in New Issue
Block a user