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 column of one reference alone is the column it reads
|
||||||
- A typed column's calc is refused unless proven
|
- A typed column's calc is refused unless proven
|
||||||
- `Column` carries text, not a Go value
|
- `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
|
- One name, one meaning
|
||||||
- The package stays flat
|
- The package stays flat
|
||||||
- The performance gate asserts allocations, not wall-clock time
|
- 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
|
// - family — a table and every table reaching it through a chain of
|
||||||
// `table.parentT`, named by the root that chain ends at: `table.familyRoot`.
|
// `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
|
// - 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
|
// the `table` itself, so it draws a row apart from every pin:
|
||||||
// its cells stand in as `surveyAt.wholePins`, beside `surveyAt.wholeTable`.
|
// `surveyAt.wholeTable`, `surveyAt.wholePins`.
|
||||||
// - fence — a load-time check, so rendering a compiled tree cannot fail: `New`
|
// - 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
|
// runs them over the data set, `NewTemplate` and `FakeStruct` over what those
|
||||||
// compile. The draw fences are `heldCheck`, `drawFence` and `checkFamilies`.
|
// 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
|
`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.
|
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
|
Goal 2 wants a name to reach one unit: `hold` is what a draw is kept in, `readValue` what
|
||||||
file the stem of the units it holds.
|
a read drew.
|
||||||
|
|
||||||
## One name, one meaning
|
## 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
|
- 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`,
|
a helper reached only through `readSurvey.check`, and misses `checkDrawGroup`,
|
||||||
`checkOwnFamily` and `checkColumnDraws`; the README's Layout indexes the fences by file.
|
`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:
|
- 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.
|
`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
|
- Cut `AGENTS.md` to the rules only it states: the round procedure stands word for word
|
||||||
|
|||||||
Reference in New Issue
Block a user