Make great documentation goal 1.2, and plan the README's reorganisation and the nested-template gaps #33
+1
-2
@@ -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
|
||||||
|
|||||||
@@ -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
|
||||||
|
|||||||
Reference in New Issue
Block a user