From 1a875387ca4ae14eb0374122c07138c9eed09b60 Mon Sep 17 00:00:00 2001 From: Lilleman auf Larv Date: Mon, 9 Nov 2026 10:48:22 +0100 Subject: [PATCH] =?UTF-8?q?Answer=20prose=20round=201:=200=20=F0=9F=94=B4,?= =?UTF-8?q?=203=20=F0=9F=9F=A1=20(0=20misread);=20title=20the=20decision?= =?UTF-8?q?=20for=20ADF=20converters=20and=20shorten=20the=20report's=20se?= =?UTF-8?q?ction?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- AGENTS.md | 2 +- docs/decisions.md | 8 ++++---- docs/kovetskiy-mark.md | 8 +++----- 3 files changed, 8 insertions(+), 10 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index e5acf35..ba52199 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -87,7 +87,7 @@ In `docs/decisions.md`: - Readable spellings take the `try` prefix - The attribute vocabulary is ADF's - The source parts by ADF and format -- The comparison table lists every converter that starts and converts +- The comparison tables list every ADF converter that starts and converts - The real-world corpus holds anonymized documents from sites whose licence it records - The feature table is a section per corpus example, led by a summary table diff --git a/docs/decisions.md b/docs/decisions.md index 93f8ae2..856952b 100644 --- a/docs/decisions.md +++ b/docs/decisions.md @@ -1195,17 +1195,17 @@ format's ban on the other format, and `ci.sh` probes every override. They are li test that scans the source, and a lint rule reads every import spelling: `from`, a bare `import`, double quotes and a dynamic `import()`. -## The comparison table lists every converter that starts and converts +## The comparison tables list every ADF converter that starts and converts 2026-10-28, the maintainer, answering the bar for the README's "Other ADF converters" table. It serves goal 3: a developer choosing a converter sees every one, and what it gets wrong. -A converter that starts and converts anything stays in its table, however poorly. Its row says where +A converter that starts and converts any ADF stays in its table, however poorly. Its row says where 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. +A converter that never reads or writes ADF is left out of both. 2026-11-09, the maintainer: +`kovetskiy/mark`, which writes Confluence storage format (`docs/kovetskiy-mark.md`), gets no row. ## The real-world corpus holds anonymized documents from sites whose licence it records diff --git a/docs/kovetskiy-mark.md b/docs/kovetskiy-mark.md index ac79f3f..1711c6c 100644 --- a/docs/kovetskiy-mark.md +++ b/docs/kovetskiy-mark.md @@ -75,12 +75,10 @@ A user of `mark` who needs ADF can fetch the page as ADF through the Confluence converts storage format to ADF. A user of this package who needs storage format goes to that same API (`README.md` §Other ADF converters). -## Does it belong in the comparison table +## Does it belong in the comparison tables -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, so it is left out of both -(`docs/decisions.md` §The comparison table lists every converter that starts and converts). +`mark` never reads or writes ADF, so it is left out of both +(`docs/decisions.md` §The comparison tables list every ADF 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).