3
0
mirror of https://github.com/larvit/adf-codec.git synced 2026-11-19 06:35:44 +01:00

Answer prose round 1: item 103 names the fix both characters share and the changelog entry it joins, item 104 names the corpus file alone, and item 84 says what to revise

This commit is contained in:
2026-10-11 16:01:25 +02:00
committed by Lillem4n
parent c0714d5fb5
commit 837d01e8da
+14 -11
View File
@@ -28,7 +28,7 @@
| 83 | 0.2.0 | defect | **Refuse a document whose markdown would pass the engine's string limit with a result, never a `RangeError`.** | 3 | 4 | 5 | 8 | 1, 9 | 22.0 | | 83 | 0.2.0 | defect | **Refuse a document whose markdown would pass the engine's string limit with a result, never a `RangeError`.** | 3 | 4 | 5 | 8 | 1, 9 | 22.0 |
| 103 | 0.2.0 | | **Fold `unspellable-whitespace` into `unsupported-node-shape`, so a line ending and a null character in a content slot take one code.** | 2 | 2 | 5 | 6 | 1 | 19.5 | | 103 | 0.2.0 | | **Fold `unspellable-whitespace` into `unsupported-node-shape`, so a line ending and a null character in a content slot take one code.** | 2 | 2 | 5 | 6 | 1 | 19.5 |
| 84 | 0.2.0 | | **Read GFM's pipe table without leading pipes, and with alignment colons, in `portableMarkdownToAdf`, dropping the alignment.** | 3 | 4 | 7 | 7 | 4, 7 | 19.4 | | 84 | 0.2.0 | | **Read GFM's pipe table without leading pipes, and with alignment colons, in `portableMarkdownToAdf`, dropping the alignment.** | 3 | 4 | 7 | 7 | 4, 7 | 19.4 |
| 104 | 0.2.0 | | **Make the README describe 0.2.0 alone: `code` stable within a minor before 1.0, no HTML call before it ships, and no file only the repo holds.** | 1 | 2 | 5 | 5 | 3 | 16.3 | | 104 | 0.2.0 | | **Make the README describe 0.2.0 alone: `code` stable within a minor before 1.0, no HTML call before it ships, and no corpus file named.** | 1 | 2 | 5 | 5 | 3 | 16.3 |
| 52 | 0.2.0 | | **Spell `colwidth` as a comma list, `colwidth="340,420"`.** | 3 | 3 | 5 | 6 | 6 | 11.5 | | 52 | 0.2.0 | | **Spell `colwidth` as a comma list, `colwidth="340,420"`.** | 3 | 3 | 5 | 6 | 6 | 11.5 |
| 53 | 0.2.0 | | **Put a block's `marks` spelling to the writer panel and adopt its pick.** | 4 | 5 | 5 | 6 | 6 | 10.0 | | 53 | 0.2.0 | | **Put a block's `marks` spelling to the writer panel and adopt its pick.** | 4 | 5 | 5 | 6 | 6 | 10.0 |
| 89 | 0.2.1 | | **Build a `date`, `emoji`, `inlineCard`, `mention` or `status` holding no mark Atlassian's schema withholds from it, in every reader.** | 4 | 4 | 5 | 6 | 4 | 13.0 | | 89 | 0.2.1 | | **Build a `date`, `emoji`, `inlineCard`, `mention` or `status` holding no mark Atlassian's schema withholds from it, in every reader.** | 4 | 4 | 5 | 6 | 4 | 13.0 |
@@ -84,27 +84,30 @@ by the README-goals audit, 2026-10-08.
### 103. Fold `unspellable-whitespace` into `unsupported-node-shape`, so a line ending and a null character in a content slot take one code. ### 103. Fold `unspellable-whitespace` into `unsupported-node-shape`, so a line ending and a null character in a content slot take one code.
`slotFault` in `directive-syntax.ts` gives a newline in an `emoji`, `mention` or `status` content `slotFault` in `directive-syntax.ts` gives a newline in an `emoji`, `mention` or `status` content
slot `unspellable-whitespace` and a null character `unsupported-node-shape`, and the README gives slot `unspellable-whitespace` and a null character `unsupported-node-shape`, though both take the
both the same remedy. A consumer switching on `code` with no `default` keeps a case for one same fix, writing the node as `!adf:carry`. Today a consumer that switches on `code` with no
character class in one slot. 0.2.0 already removes the other `unspellable-*` codes; folding this `default` needs a case for a code only a line ending in these three slots raises. 0.2.0 already
one later is a break. Revise §Which code a cause takes, and add the change to the changelog's removes the other `unspellable-*` codes, so folding this one in now adds no new break; later it
breaking entry, `MIGRATION.md` and the README's error table. Found by the product-owner review of would be a break of its own. Revise §Which code a cause takes, and add the change to the changelog
entry that removes `unspellable-character`, to `MIGRATION.md`'s Error codes table and to the
README's error table. Found by the product-owner review of
0.2.0, 2026-10-11. 0.2.0, 2026-10-11.
### 84. Read GFM's pipe table without leading pipes, and with alignment colons, in `portableMarkdownToAdf`, dropping the alignment. ### 84. Read GFM's pipe table without leading pipes, and with alignment colons, in `portableMarkdownToAdf`, dropping the alignment.
Models write `|:---|` delimiter rows and tables without a leading pipe; both are Models write `|:---|` delimiter rows and tables without a leading pipe; both are
`malformed-pipe-table` today, and `portableMarkdownToAdf` is the bot's reader. ADF holds no column `malformed-pipe-table` today, and `portableMarkdownToAdf` is the bot's reader. ADF holds no column
alignment, so the portable reader drops it (Goal 7: form, never content). The lossless reader keeps alignment, so the portable reader drops it (Goal 7: form, never content). `losslessMarkdownToAdf` keeps
§Tables' narrowing. §Which code a cause takes then names the alignment colon as a lossless refusal. both refusals. Revise §Which code a cause takes so the alignment colon is `malformed-pipe-table` in
that reader alone, and the README's pipe-table guarantee and `malformed-pipe-table` row to match.
### 104. Make the README describe 0.2.0 alone: `code` stable within a minor before 1.0, no HTML call before it ships, and no file only the repo holds. ### 104. Make the README describe 0.2.0 alone: `code` stable within a minor before 1.0, no HTML call before it ships, and no corpus file named.
- The README says `code` is stable across minors; §The code list changes codes in any 0.x minor. - The README says `code` is stable across minors; §The code list changes codes in any 0.x minor.
- The README lists `adfToHtml` and `htmlToAdf` in its signatures, error tables and guarantees, - The README lists `adfToHtml` and `htmlToAdf` in its signatures, error tables and guarantees,
marked `0.3.0`, against §Docs describe the release being built. Item 7 writes them back. marked `0.3.0`, against §Docs describe the release being built. Item 7 writes them back.
- The CommonMark guarantees name `corpus/commonmark-spec/exceptions.json` and its kinds, which an - The CommonMark guarantees name `corpus/commonmark-spec/exceptions.json` and its kinds, which tell
npm reader cannot open. an app developer nothing about what the library does.
Found by the product-owner review of 0.2.0, 2026-10-11. Found by the product-owner review of 0.2.0, 2026-10-11.