10c - prose: the lossy pair folds into §1, §15's ask rule said once
This commit was merged in pull request #130.
This commit is contained in:
@@ -7,11 +7,10 @@ that item's entry in `todo-history.md`.
|
|||||||
## 1. Three formats, ADF is the hub
|
## 1. Three formats, ADF is the hub
|
||||||
|
|
||||||
ADF, one markdown flavour, one HTML dialect. Six directions exposed, but markdown↔HTML compose
|
ADF, one markdown flavour, one HTML dialect. Six directions exposed, but markdown↔HTML compose
|
||||||
through ADF: four conversions exist to keep correct — never write a fifth. No fourth format, ever;
|
through ADF: four conversions exist to keep correct — never write a fifth. The lossy pair wraps
|
||||||
each one doubles the directions.
|
two of them, an ADF→ADF reduction ahead of `adfToMarkdown` and an ADF→ADF lift after
|
||||||
|
`markdownToAdf`, and whatever it adds stays ADF→ADF (the maintainer, 2026-09-14). No fourth format,
|
||||||
The lossy pair is no fifth: `adfToPlainMarkdown` reduces ADF→ADF ahead of `adfToMarkdown`, and
|
ever; each one doubles the directions.
|
||||||
`plainMarkdownToAdf` lifts ADF→ADF after `markdownToAdf` (the maintainer, 2026-09-14).
|
|
||||||
|
|
||||||
## 2. The round-trip is the product
|
## 2. The round-trip is the product
|
||||||
|
|
||||||
@@ -419,18 +418,16 @@ bump on `main` publishes, §9 — every release is the maintainer's) and the `NP
|
|||||||
|
|
||||||
### Ask, don't guess
|
### Ask, don't guess
|
||||||
|
|
||||||
Any choice where what the maintainer would pick is not near-certain gets asked, and the answer
|
Any choice where what the maintainer would pick is not near-certain gets asked. The confidence bar
|
||||||
lands as a decision in this file. The confidence bar is very high — asking too often is the
|
is very high — asking too often is the accepted cost, guessing wrong is not.
|
||||||
accepted cost, guessing wrong is not.
|
|
||||||
|
|
||||||
An ask is a gap in this file, and its answer is the rule that closes the gap, never the instance
|
An ask is a gap in this file, and its answer is the rule that closes it, landing here — never the
|
||||||
alone. Before asking, name the class the question belongs to and the earlier `(the maintainer, …)`
|
instance alone. Before asking, name the class the question belongs to and the earlier
|
||||||
entries of that class; where a rule already decides it, apply it without asking, and where the rule
|
`(the maintainer, …)` entries of that class; where a rule already decides it, apply it without
|
||||||
reads two ways on this input, that reading is the ask. Never ask "A or B?": state the gap, the
|
asking, and where the rule reads two ways on this input, that reading is the ask. Never ask "A or
|
||||||
earlier asks of its class, the nearest text here, a candidate rule in this file's voice and section,
|
B?": state the gap, the earlier asks of its class, the nearest text here, a candidate rule in this
|
||||||
and the instance it yields, and ask for the rule. The maintainer answers the rule, the rule lands
|
file's voice and section, and the instance it yields. A rule that keeps collecting instances is
|
||||||
here, and the instance follows from it in the chunk. A rule that keeps collecting instances is
|
wrong: rewrite it.
|
||||||
wrong: rewrite it rather than append to it.
|
|
||||||
|
|
||||||
Which output the audience expects — README goal 5 — is settled by a reader panel rather than
|
Which output the audience expects — README goal 5 — is settled by a reader panel rather than
|
||||||
asked: three fresh-context readers, one per README persona the conversion serves, each given only
|
asked: three fresh-context readers, one per README persona the conversion serves, each given only
|
||||||
|
|||||||
Reference in New Issue
Block a user