29 - the spec stands: raw HTML routes through the element mapping
CI / gate (push) Successful in 29s
CI / publish (push) Waiting to run

This commit was merged in pull request #112.
This commit is contained in:
2026-09-20 21:53:07 +02:00
parent 77ae596d2e
commit eed1ac0290
+10 -8
View File
@@ -40,14 +40,16 @@ panel says the next reader pays for.
29 and 30 come from 17's prose pass (2026-09-20). 29 reads first because every goal is what a later
ask is settled against, 19's included; 30 sits beside 25, the other chunk rereading AGENTS.md.
- [ ] **29 — Goal 3 names the whole of the exception (`0.2.0`).** README §Goals 3 says "the three
carve-outs and the one gap below are the whole of the exception", and §The guarantees says
"apart from the raw HTML below, with three carve-outs … and one gap". Raw HTML is a fourth
exception, the commonest one in markdown written elsewhere, and `unmappable-html` refuses it
today. Name it in the goal, or stop enumerating there. Settle at the same time whether the
goal is written for `0.2.0`, where the element mapping the error text promises could make
raw HTML convert — the answer decides which repair is the true one, so it is the
maintainer's.
- [ ] **29 — The README reads raw HTML as refused for good (`0.2.0`).** §Goals 3 says "the three
carve-outs and the one gap below are the whole of the exception" and §The guarantees says
"Raw HTML in markdown input is an error result", both reading as settled, where
`spec/flavour.md` §Raw HTML in input says the opposite: `markdownToAdf` routes each construct
through the foreign HTML element mapping, and only a construct without one is refused. The
spec stands — commonplace markdown is accepted, and every tool writes some HTML (the
maintainer, 2026-09-20). So rewrite the two README texts to name the exception that survives
6 and 7, a construct outside the documented element set, and state it in one place, since
three already spell this one rule. `markdown-to-adf.ts:73` and `inline-content.ts:158` are
the whole of the refusal and already say "at this version"; 7 is what makes them route.
- [ ] **30 — AGENTS.md says each thing once (`0.2.0`).** §15's ask protocol — name the class, cite
the earlier asks of it, never "A or B?" — is the rule reviewers cite most and has no heading,
two thirds down a 50-line section in a file with no index. Give it one. §15 also offers "the