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
2 changed files with 4 additions and 3 deletions
Showing only changes of commit 55eacf0319 - Show all commits
+1 -2
View File
@@ -390,8 +390,7 @@ parent. A row is selected or drawn alike.
- Where a segment follows, the link column's name reads the parent row, one level per - Where a segment follows, the link column's name reads the parent row, one level per
step, chained: `city[Oslo].country.name` renders `Norway`, `locality.municipality.name` step, chained: `city[Oslo].country.name` renders `Norway`, `locality.municipality.name`
the drawn locality's municipality, and `geo.SE.locality[Lund].municipality.region.name` the drawn locality's municipality, and `geo.SE.locality[Lund].municipality.region.name`
Lund's region. The parent row of a selected row is fixed as the selection is, so Lund's region.
`city[Oslo].country.city.name` draws a city of Norway, which may not be Oslo.
- A path ending on it is refused at `New`, `NewTemplate` and `Fake` alike, naming the - A path ending on it is refused at `New`, `NewTemplate` and `Fake` alike, naming the
parent's key column and the parent's format spelled as paths: with a `country` format parent's key column and the parent's format spelled as paths: with a `country` format
of `{name} ({alpha2})`, `city[Oslo].country` names `city[Oslo].country.alpha2` and of `{name} ({alpha2})`, `city[Oslo].country` names `city[Oslo].country.alpha2` and
+3 -1
View File
@@ -175,7 +175,7 @@ by a `data-import/` script, as README goal 12 asks.
- Step up from a row to its parent as the decision "A link column after a row steps up - Step up from a row to its parent as the decision "A link column after a row steps up
to the parent row, and a path may not end on it" states: `city[Oslo].country.name` is to the parent row, and a path may not end on it" states: `city[Oslo].country.name` is
a load error today, and `city[Oslo].country` renders the cell `NO`, as a load error today, and `city[Oslo].country` renders the cell `NO`, as
`locality.municipality` does, which `List` advertises. Replace the README's `locality.municipality` does, which `List` stops advertising. Replace the README's
`city[Oslo].country` example with `fejkdata -d ./mydata 'city[Oslo].country.name'`, `city[Oslo].country` example with `fejkdata -d ./mydata 'city[Oslo].country.name'`,
rendering `Norway`. rendering `Norway`.
- Render selected rows as the decision "A selected row is fixed, not drawn, and an - Render selected rows as the decision "A selected row is fixed, not drawn, and an
@@ -227,6 +227,8 @@ by a `data-import/` script, as README goal 12 asks.
### Open questions to settle ### Open questions to settle
- Decide what a path stepping up and back down renders, per goal 4's writer check:
`city[Oslo].country.city.name` could be Oslo or a city of Norway drawn afresh.
- Decide whether a route through another row is a second spelling of one result: - Decide whether a route through another row is a second spelling of one result:
`city[Oslo].country.name` and `country[NO].name` always render `Norway`, and goal 4 `city[Oslo].country.name` and `country[NO].name` always render `Norway`, and goal 4
refuses a second spelling, while `country[NO]` and `country[Norway]` both select one refuses a second spelling, while `country[NO]` and `country[Norway]` both select one