larvit/adf-codec
3
0
Fork 0
mirror of https://github.com/larvit/adf-codec.git synced 2026-11-12 11:48:29 +01:00
Code Activity

Leave a converter that never touches ADF out of the comparison tables

Browse Source
This commit is contained in:
Lilleman auf Larv
2026-11-09 10:46:30 +01:00
committed by Lillem4n
parent 7684643e6b
commit 93d506ddb7
3 changed files with 5 additions and 17 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/decisions.md
+3
View File
@@ -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
docs/kovetskiy-mark.md
+2 -2
View File
@@ -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).
todo.md
-15
View File
@@ -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