diff --git a/AGENTS.md b/AGENTS.md index a66402a..1d51302 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -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 diff --git a/doc.go b/doc.go index 787891b..b5f8528 100644 --- a/doc.go +++ b/doc.go @@ -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`. diff --git a/docs/decisions.md b/docs/decisions.md index 927f672..cb62999 100644 --- a/docs/decisions.md +++ b/docs/decisions.md @@ -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 diff --git a/todo.md b/todo.md index 41aa6ec..86501a4 100644 --- a/todo.md +++ b/todo.md @@ -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