Make great documentation goal 1.2, and plan the README's reorganisation and the nested-template gaps #33

Open
lilleman wants to merge 966 commits from worktree-todo-relative-dates-exact-counts into main
Showing only changes of commit e6a1a7aa8b - Show all commits
+18 -7
View File
@@ -220,13 +220,24 @@ by a `data-import/` script, as README goal 12 asks.
### Open questions to settle
- Decide how a path steps from a row up to its parent row: three simulated template
writers expected `{/geo.SE.locality[Lund].municipality.name}` to read Lund's
municipality, which goal 4 asks for, but `.municipality` after a row is already the
link column's cell, `city[Oslo].country` rendering `NO`. So either the name means the
cell where it ends a path and the parent row where a segment follows, which the
decisions "One name, one meaning" and "`parent` names the link column and the table
alike" have to allow, or the step up takes a spelling of its own.
- Decide how a path steps from a row up to its parent row, one level per step, chained.
Three simulated template writers expected `{/geo.SE.locality[Lund].municipality.name}`
to read Lund's municipality; today it is a load error, since `.municipality` after a
row is the link column's cell, `city[Oslo].country` rendering `NO`. The options:
- The name means the parent row where a segment follows, and the cell where the path
ends. It gives a refused spelling a meaning, so a minor, and extends "After a row, a
path names a column or a linked table" from child tables to the parent.
- The name always means the parent row, rendering through its format where the path
ends: `city[Oslo].country` renders `Norway`, the cell stays reachable through the
parent's key column. A change
to what exists, so a major, and a record's `country` column then holds the key while
the path renders the name.
- Goal 4 refuses a path ending on the name, since a writer could expect the code or the
name, naming the parent's key column and `.name`. A major.
Either of the first two gives `locality[Lund].municipality.name` and
`municipality[1281].name` one result, so goal 4's one spelling per result refuses one
of them, and the rewrite the selected-row item above names follows that choice.
- Decide whether a goal 5 violation joins the comprehension gate's exception list: the
`{/sel}|{/sel}` panic waits behind the whole round at 5.9, and
`{/geo.SE.locality}|{/geo.SE.municipality}` mispairs the shipped data meanwhile, though a