mirror of
https://github.com/larvit/adf-codec.git
synced 2026-11-18 22:25:44 +01:00
Answer architecture round 1: the claims type pins what every writer spells, the HTML calls take flavour names, model-written GFM reads in portableMarkdownToAdf
This commit is contained in:
@@ -0,0 +1,26 @@
|
||||
# Comprehension history
|
||||
|
||||
## 2026-10-09T00:41:03Z, PR #19 at 859c952, against 9519606
|
||||
|
||||
Ruling: better
|
||||
|
||||
| Seat | Vote |
|
||||
|---|---|
|
||||
| Mid A | better |
|
||||
| Inherited architect | better |
|
||||
|
||||
Mid A, decided by:
|
||||
|
||||
- `src/markdown/portable/task-ids.ts:7` `mintTaskIds`: one walk, no carried set filled by the parser as a side effect
|
||||
- `src/markdown/parse/markdown-to-adf.ts:26` `Reading`: plain data, `codeBlockNode` no longer mutates `carried`
|
||||
- `src/markdown/portable/conventions.ts:8` `flavourClaims`: one table states what each reader claims; branches name the claim they test
|
||||
- `src/markdown/parse/markdown-to-adf.ts:161` `quoteNode`: the title is read in the reader's own flavour, no hop through `inlineLeaves`
|
||||
- `src/index.ts:5` exports: each call named by its flavour; "plain" no longer means two things
|
||||
|
||||
Inherited architect, decided by:
|
||||
|
||||
- `src/markdown/parse/markdown-to-adf.ts:26` `Reading`: the hidden `carried` set and the retrying `mintTaskIds` are gone
|
||||
- `src/markdown/parse/markdown-to-adf.ts:161` `quoteNode`: parser and emitter no longer correct only together
|
||||
- `src/markdown/parse/markdown-to-adf.ts:113` `readBlock`: branches name the claim (`claims.alerts`, `claims.taskMarkers`)
|
||||
- `src/index.ts:5` exports: flavour names say which file to open
|
||||
- `src/markdown/portable/conventions.ts:3` `flavourClaims`: cost, all three flavours' rows live under `portable/`
|
||||
+2
-1
@@ -13,7 +13,8 @@ A function's name says which markdown it reads or writes, and a reader reads tha
|
||||
| `commonMarkToAdf` | CommonMark as its spec says: a directive, a pipe table, `~~`, `==` and an `adf:` fence read as CommonMark reads them |
|
||||
| `adfToPortableMarkdown`, `portableMarkdownToAdf` | CommonMark, GFM's pipe tables, `~~`, alerts and task markers, and Obsidian's callouts and `==`; no directive and no `adf:` fence |
|
||||
|
||||
No `adfToCommonMark`: the portable writer serves every persona a CommonMark writer would. The panel
|
||||
The calls between markdown and HTML that `todo.md` item 7 ships take their flavour's name too. No
|
||||
`adfToCommonMark`: the portable writer serves every persona a CommonMark writer would. The panel
|
||||
picked `portable` 4 of 7 over `plain` 3, `gfm` and `rendered` none: the export readers read it as
|
||||
"renders anywhere, lossy", and three readers read `plain` as holding no tables or alerts.
|
||||
|
||||
|
||||
Reference in New Issue
Block a user