diff --git a/docs/comprehension-history.md b/docs/comprehension-history.md index a76056b..9e99a2c 100644 --- a/docs/comprehension-history.md +++ b/docs/comprehension-history.md @@ -20,3 +20,24 @@ Inherited architect, decided by: - `pick.go:9` `pickKey`: the 3am path for a named pick now ends in one file, with its worked example - `render.go:155` `readField`: `keptInPick` holds its own nil and reference checks - `path.go:72` `compiledPath`: the field no longer reuses the vocabulary word level + +## 2026-10-09T09:24:31Z, PR #190 at 65a32db, against ee4b40b + +Ruling: better + +| Seat | Vote | +|---|---| +| Mid A | better | +| Inherited architect | better | + +Mid A, decided by: + +- `pick.go:9` `pickKey`: the definitions sit on the type, beside the functions that build and read the keys +- `datatype.go:217` `columnRead`: beside `itemDatatype` and `checkColumns`, which consume it +- `node.go:70` `template.readsColumn`: names the four readers that change together + +Inherited architect, decided by: + +- `pick.go:9` `pickKey`: a pick-key bug needs one file, where it needed four and the vocabulary +- `render.go:155` `readField`: one named predicate, `keptInPick`, states the keep rule +- `path.go:72` `compiledPath`: `headSpans` is the costliest new read in the diff