diff --git a/docs/decisions.md b/docs/decisions.md index a08b072..93f8ae2 100644 --- a/docs/decisions.md +++ b/docs/decisions.md @@ -1204,6 +1204,9 @@ A converter that starts and converts anything stays in its table, however poorly it fails ordinary input, such as a list or a quote. A converter that doesn't start, or needs a page rather than Node, goes in the second table. A wrapper or fork of a listed package is left out. +A converter that never reads or writes ADF is left out of both. 2026-11-09, the maintainer: a Go +program that writes Confluence storage format (`docs/kovetskiy-mark.md`) gets no row. + ## The real-world corpus holds anonymized documents from sites whose licence it records 2026-11-04, on the maintainer's answers of 2026-11-03, and their answer of 2026-11-05 accepting the diff --git a/docs/kovetskiy-mark.md b/docs/kovetskiy-mark.md index 2027d9c..ac79f3f 100644 --- a/docs/kovetskiy-mark.md +++ b/docs/kovetskiy-mark.md @@ -79,8 +79,8 @@ API (`README.md` §Other ADF converters). Neither table fits. The first lists npm packages that run in Node and convert ADF to or from markdown. The second lists converters the comparison does not run, and every library in it converts -ADF. `mark` is a Go program that never touches ADF. Item 177 asks the maintainer: leave it out, or -add a row to the second table saying it converts markdown to storage format and not ADF. +ADF. `mark` is a Go program that never touches ADF, so it is left out of both +(`docs/decisions.md` §The comparison table lists every converter that starts and converts). No spelling changes follow: `[!IMPORTANT]` is the README's choice to reopen, not a defect, and only a writer panel changes a spelling (`AGENTS.md` §7). diff --git a/todo.md b/todo.md index 500ebe3..0a2877e 100644 --- a/todo.md +++ b/todo.md @@ -13,7 +13,6 @@ | ID | Release | Blocked by | Exempt | Item | L | E | I | R | S | Moves | Score | |---|---|---|---|---|---|---|---|---|---|---|---| | 153 | 0.4.0 | | question | **Decide whether `src/markdown/` root may import `emit/`, `parse/` or `portable/`, and hold the answer in `.oxlintrc.json` and §The source parts by ADF and format.** | 1 | 2 | 2 | 3 | 2 | code health by 3 | 26.2 | -| 177 | 0.4.0 | | question | **Decide whether `kovetskiy/mark`, a Go program that writes Confluence storage format and never touches ADF, gets a row in the README's second "Other ADF converters" table, and record the answer in §The comparison table lists every converter that starts and converts.** | 1 | 2 | 1 | 2 | 1 | 3 by 1 | 2.5 | | 112 | 0.4.0 | | | **Pad a GFM pipe table's short rows with empty cells, read its body rows holding no pipe, and read a one-column table without leading pipes in `portableMarkdownToAdf`.** | 2 | 1 | 2 | 3 | 3 | 4 by 4 | 6.2 | | 80 | 0.4.0 | | | **Name the node's path and the attribute key when `not-an-adf-document` refuses a node inside the document.** | 2 | 1 | 2 | 3 | 3 | 6 by 4 | 6.0 | | 171 | 0.4.0 | | principle | **Assert the facts an error message must carry, never its whole sentence, in `markdown-to-adf.test.ts`, `document.test.ts` and `html-to-adf.test.ts`.** | 3 | 1 | 1 | 3 | 6 | code health by 3 | 4.4 | @@ -63,20 +62,6 @@ a paragraph opening with a spellable `!adf:link` (§Nothing recurses unbounded). `src/markdown/**` bans only `html/`; banning `emit/`, `parse/` and `portable/` for the root's own files, with its `ci.sh` probe, extends the decision. -### 177. Decide whether `kovetskiy/mark`, a Go program that writes Confluence storage format and never touches ADF, gets a row in the README's second "Other ADF converters" table, and record the answer in §The comparison table lists every converter that starts and converts. - -The gap: the decision entry "The comparison table lists every converter that starts and converts" -settles which npm packages and which other-ecosystem libraries are listed, and all of them convert -ADF. The first table lists npm packages that run in Node and convert ADF to or from markdown; the -second lists converters the comparison does not run, and every library in it converts ADF. `mark` -converts markdown to storage format only (`docs/kovetskiy-mark.md`, "Does it belong in the -comparison table"). The options: leave it out, or add a row saying it converts markdown to storage -format and not ADF. - -Candidate sentence for the entry: "A converter that never reads or writes ADF, such as one writing -Confluence storage format, is left out." Recommended: leave it out, unless the maintainer wants -non-ADF neighbours listed. - ### 112. Pad a GFM pipe table's short rows with empty cells, read its body rows holding no pipe, and read a one-column table without leading pipes in `portableMarkdownToAdf`. GFM pads a short row with empty cells, reads a line holding no `|` after a table as a row, and