3
0
mirror of https://github.com/larvit/adf-codec.git synced 2026-11-20 07:05:44 +01:00

Answer prose round 1: 4 🔴, 6 🟡 (0 misread); state the shapes moved and what holds today, and drop the mark rule

This commit is contained in:
2026-11-04 20:51:28 +01:00
committed by Lillem4n
parent 5af77d0a5e
commit 7a7b12b6a7
4 changed files with 49 additions and 46 deletions
+21 -21
View File
@@ -17,7 +17,7 @@
| 165 | 0.3.0 | 164 | | **Have a reader panel seated from `## Audience` judge each feature-table row reasonable or not, and file an item for each row it rejects.** | 2 | 2 | 1 | 3 | 3 | 6 by 5 | 7.5 |
| 132 | 0.3.0 | | | **Write tables as `<table>` in `adfToHtml` and read them back in `htmlToAdf`, in place of the carry element.** | 2 | 2 | 2 | 4 | 5 | 6 by 4 | 2.4 |
| 73 | 0.3.0 | 132, 163, 165 | | **Announce the package where someone needing an ADF converter already reads: JRACLOUD-77436, the Atlassian developer community and Stack Overflow's ADF-to-markdown questions.** | 1 | 2 | 2 | 3 | 2 | 3 by 8 | 16.9 |
| 167 | 0.3.0 | | decision | **Check every Atlassian-schema rule a writer refuses today in `writableContent`, and drop it from the writers.** | 3 | 1 | 2 | 4 | 5 | code health by 5 | 13.1 |
| 167 | 0.3.0 | | decision | **Refuse in `refusedShape` the schema-forbidden shapes `adfToLosslessMarkdown` refuses in its walk, and drop them from that writer.** | 3 | 1 | 2 | 4 | 5 | code health by 5 | 13.1 |
| 72 | 0.3.0 | 132 | decision | **Re-create `gitea.larvit.se/larvit/adf-codec` as a read-only pull mirror of GitHub, its issues and Actions off and its description pointing at GitHub.** | 1 | 2 | 1 | 2 | 1 | 3 by 1 | 2.5 |
| 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 |
| 156 | 0.4.0 | | | **Stop a leg's container when its script is interrupted, so Ctrl-C ends `ci.sh` or `mutation-tests/run.sh` at once.** | 1 | 2 | 1 | 2 | 1 | code health by 2 | 20.9 |
@@ -106,29 +106,29 @@ solves it, then links the GitHub repository, the README's comparison table and t
opening. The maintainer posts them once `0.3.0` is published (`docs/decisions.md` §Posts
announcing a release wait for its publish). Found while planning discoverability, 2026-10-04.
### 167. Check every Atlassian-schema rule a writer refuses today in `writableContent`, and drop it from the writers.
### 167. Refuse in `refusedShape` the schema-forbidden shapes `adfToLosslessMarkdown` refuses in its walk, and drop them from that writer.
The maintainer's call, 2026-11-04 (`docs/decisions.md` §The first step checks the schema, and no
converter does): the first step holds every schema check, "moved there from wherever else in the
code they are". It replaces item 68, which would have carried these shapes: a schema-forbidden
shape is refused once, with its path, in every writer. Move into `refusedShape`:
The maintainer's call, 2026-11-04 (`docs/decisions.md` §Schema refusals are made in the first step
alone): the first step holds every schema check, "moved there from wherever else in the code they
are". It replaces item 68, which would have carried these shapes. Move into `refusedShape`:
- `emitLeaf` in `emit/inline-line.ts`: a node holding one mark type twice, and an inline node
holding neither `content` nor `text`.
- `emitDirectiveBlock` in `emit/adf-to-markdown.ts`: a node holding `text`, and a leaf block holding
`content`.
- The HTML and portable writers, which today write the first two without refusing: they refuse them
too, which is breaking for a document holding either (`CHANGELOG.md`, `MIGRATION.md`).
- Check `src/html/` and `src/markdown/portable/` for a refusal of this kind the grep of
`unsupported-node-shape` missed, and `carriedNode` for a rule the readers still build.
- `emitDirectiveBlock` in `emit/adf-to-markdown.ts`: a block holding `text`, and a leaf block
holding `content`.
- `emitLeaf` in `emit/inline-line.ts`: a non-text inline node holding `content` or `text`.
Stays where it is: a limit of the engine or the flavour (nesting depth, output length, a portable
task list holding what no list item spells) and a reader's refusal of markdown or HTML it cannot
read. A node type, mark or attribute the schema does not name, a known node out of place and a mark
a node cannot hold keep riding the carry. Drop the refused shapes from the README's
`unsupported-node-shape` causes under writing and from `spec/flavour.md`; the property generators
build none of them. Lands with items 45, 77 and 80 where it can, since their reader walks every
node too, but needs none.
Atlassian's schema gives each such node no `text` or `content` (`additionalProperties` is false).
Breaking: `adfToHtml` and `adfToPortableMarkdown` refuse these shapes too, and so does
`adfToLosslessMarkdown` inside a node that rides the carry, where it writes them today. Say so in
`CHANGELOG.md` and `MIGRATION.md`. Search the writers for any other refusal of a shape the schema
forbids, and `carriedNode` for one the readers still build.
Stays where it is: a node holding one mark type twice (the schema allows it, no spelling holds it),
nesting depth, output length, a portable task list holding what no list item spells, and a
reader's refusal of markdown or HTML it cannot read. A node type, mark or attribute the schema does
not name, a known node out of place and a mark a node cannot hold keep riding the carry. Drop the
refused shapes from the README's `unsupported-node-shape` cause under writing in
`adfToLosslessMarkdown` and add them to the cause common to the writers, and from `spec/flavour.md`;
the property generators build none of them.
### 72. Re-create `gitea.larvit.se/larvit/adf-codec` as a read-only pull mirror of GitHub, its issues and Actions off and its description pointing at GitHub.