Title the stem decision by its rule, and point doc.go's whole at surveyAt

This commit is contained in:
2026-09-29 03:00:31 +02:00
committed by Lillem4n
parent ecc7833e04
commit 4e4254fa84
4 changed files with 7 additions and 6 deletions
+1 -1
View File
@@ -65,7 +65,7 @@ In [docs/decisions.md](docs/decisions.md):
- A column of one reference alone is the column it reads
- A typed column's calc is refused unless proven
- `Column` carries text, not a Go value
- `hold` names what a draw is kept in, `readValue` what a read drew
- A unit takes the stem of what it is, and a file the stem of the units it holds
- One name, one meaning
- The package stays flat
- The performance gate asserts allocations, not wall-clock time
+2 -2
View File
@@ -33,8 +33,8 @@ package fejkdata
// - family — a table and every table reaching it through a chain of
// `table.parentT`, named by the root that chain ends at: `table.familyRoot`.
// - whole — a read of a table with no selector and no descent, {/city}, landing on
// the `table` itself: it draws a row apart from every pin, so the fences keep the rows
// its cells stand in as `surveyAt.wholePins`, beside `surveyAt.wholeTable`.
// the `table` itself, so it draws a row apart from every pin:
// `surveyAt.wholeTable`, `surveyAt.wholePins`.
// - fence — a load-time check, so rendering a compiled tree cannot fail: `New`
// runs them over the data set, `NewTemplate` and `FakeStruct` over what those
// compile. The draw fences are `heldCheck`, `drawFence` and `checkFamilies`.
+3 -3
View File
@@ -302,10 +302,10 @@ in.
`Value` is the rendered string beside `DataType` and `Null`, which each serializer
writes as the load check proved it; a `Value any` would hand every caller a type switch.
## `hold` names what a draw is kept in, `readValue` what a read drew
## A unit takes the stem of what it is, and a file the stem of the units it holds
Goal 2 wants a name to reach one unit, so a unit takes the stem of what it is, and a
file the stem of the units it holds.
Goal 2 wants a name to reach one unit: `hold` is what a draw is kept in, `readValue` what
a read drew.
## One name, one meaning
+1
View File
@@ -312,6 +312,7 @@ because pairing a street with its exact postnummer rewrites shipped rows.
- Delete `doc.go`'s "The draw fences are …" sentence: it names a function, a type and
a helper reached only through `readSurvey.check`, and misses `checkDrawGroup`,
`checkOwnFamily` and `checkColumnDraws`; the README's Layout indexes the fences by file.
Say "fences" in the `pin` entry then, which names the draw fences too.
- Cut the README's Layout block to the lines that say what a file name cannot:
`calc.go`, `doc.go` and `cmd/fejkdata/` restate their names.
- Cut `AGENTS.md` to the rules only it states: the round procedure stands word for word