Title the stem decision by its rule, and point doc.go's whole at surveyAt
This commit is contained in:
@@ -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
|
||||
|
||||
@@ -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
@@ -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
|
||||
|
||||
|
||||
@@ -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
|
||||
|
||||
Reference in New Issue
Block a user