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

Answer prose round 1: 0 🔴, 5 🟡; put the boundaries' reason in the source-parts entry and drop item 127's overreach

This commit is contained in:
2026-10-22 01:40:18 +02:00
committed by Lillem4n
parent c2fa6fa9b0
commit 6eb81a5ce6
2 changed files with 15 additions and 15 deletions
+13 -11
View File
@@ -672,11 +672,11 @@ compared against `undefined` — have a half no valid document reaches.
## The size ratchet ## The size ratchet
2026-09-20, the import boundaries 2026-10-22, the maintainer. KISS, a technical principle. Valid 2026-09-20, the maintainer; the import boundaries, 2026-10-22, the maintainer. KISS, a technical
while no measure picks out what readers find hard better than a function's length. principle. Valid while no measure picks out what readers find hard better than a function's length.
`.oxlintrc.json` holds one size rule and the import boundaries of §The source parts by ADF and `.oxlintrc.json` holds one size rule. It also holds the import boundaries §The source parts by ADF
format. The size rule, over the files `tsconfig.build.json` builds, is a per-function line and format draws. The size rule, over the files `tsconfig.build.json` builds, is a per-function line
ceiling, set at that set's worst and moving only downward. It covers the built files alone, since ceiling, set at that set's worst and moving only downward. It covers the built files alone, since
one ceiling over the tests too would have to be their worst, loosening the guard over the shipped one ceiling over the tests too would have to be their worst, loosening the guard over the shipped
code. It guards against drift and never drives a refactor, so no cyclomatic rule and no second size code. It guards against drift and never drives a refactor, so no cyclomatic rule and no second size
@@ -688,9 +688,6 @@ config gone missing fails the leg instead of falling back to oxlint's own defaul
`--deny-warnings`, since a rule from a category this config never names arrives as a warning it `--deny-warnings`, since a rule from a category this config never names arrives as a warning it
exits 0 on. exits 0 on.
The boundaries are `no-restricted-imports` overrides over the same files, since the technical
principles refuse a test that scans the source and a regex misses import spellings a rule reads.
## The project ships under the comprehension floor until items 62 and 95 land ## The project ships under the comprehension floor until items 62 and 95 land
2026-10-03, the maintainer; item 95 in place of item 61, 2026-10-09, the maintainer. KISS, a 2026-10-03, the maintainer; item 95 in place of item 61, 2026-10-09, the maintainer. KISS, a
@@ -913,8 +910,9 @@ is the markdown flavour's choice, not ADF's.
## The source parts by ADF and format ## The source parts by ADF and format
2026-08-27, placement 2026-09-18, `adf/`'s bar 2026-09-21, `plain/` 2026-10-03, the maintainer. 2026-08-27, placement 2026-09-18, `adf/`'s bar 2026-09-21, `plain/` 2026-10-03, the import
Goal 2. Valid while each format has a reader and a writer through ADF. boundaries' lint 2026-10-22, the maintainer. Goal 2. Valid while each format has a reader and a
writer through ADF.
`src/adf/` holds ADF's own knowledge, imports no format, and is where a construct both formats read `src/adf/` holds ADF's own knowledge, imports no format, and is where a construct both formats read
lives: the question is answered in ADF's vocabulary — a node type, an attribute kind, a content lives: the question is answered in ADF's vocabulary — a node type, an attribute kind, a content
@@ -939,5 +937,9 @@ whether a list marker interrupts a paragraph — is one function there too, neve
direction, however conservative the copy would be. Where the rule is the emitter's own choice, input direction, however conservative the copy would be. Where the rule is the emitter's own choice, input
consults it rather than restating it, so no fixture the emitter writes can be refused, and a consults it rather than restating it, so no fixture the emitter writes can be refused, and a
spelling the emitter refuses gives its own error rather than a second name for it. That consulting spelling the emitter refuses gives its own error rather than a second name for it. That consulting
is the only import `parse/` takes from `emit/`, through `emit/spelling-questions.ts`. `.oxlintrc.json` holds that import, and keeps is the only import `parse/` takes from `emit/`, through `emit/spelling-questions.ts`.
`markdown/directive/` from importing `emit/` or `parse/` (§The size ratchet).
`.oxlintrc.json` enforces that limit for `markdown/parse/`, and keeps `markdown/directive/` from
importing `emit/` or `parse/`, as `no-restricted-imports` overrides. They are lint rules because the
technical principles refuse a test that scans the source, and a lint rule reads every import
spelling: `from`, a bare `import`, double quotes and a dynamic `import()`.
+2 -4
View File
@@ -204,10 +204,8 @@ Three tests read source text:
production cause and every call site names a declared code. A code held in a variable or passed production cause and every call site names a declared code. A code held in a variable or passed
through another helper escapes it. through another helper escapes it.
Item 81 changes `result.test.ts` too. `docs/decisions.md` §The size ratchet now lets Item 81 changes `result.test.ts` too. Found by the technical-principles audit of
`.oxlintrc.json` hold rules beyond the size ceiling, so the `JSON.parse` ban can become a lint item 60, 2026-10-22.
rule. Found by the technical-principles audit of item 60,
2026-10-22.
### 112. Pad a GFM pipe table's short rows with empty cells, read its body rows holding no pipe, and read a one-column table without leading pipes in `portableMarkdownToAdf`. ### 112. Pad a GFM pipe table's short rows with empty cells, read its body rows holding no pipe, and read a one-column table without leading pipes in `portableMarkdownToAdf`.