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
3 changed files with 11 additions and 6 deletions
Showing only changes of commit 67ff2b258e - Show all commits
+1 -3
View File
@@ -79,9 +79,7 @@ func contained(n node) []namedNode {
} }
// named skips a bound {/path} key: it is a render edge, not containment, so using // named skips a bound {/path} key: it is a render edge, not containment, so using
// it as a path segment would report a node under a path that does not reach it. Only // it as a path segment would report a node under a path that does not reach it.
// a template's fields hold bindings — loadDir skips a dot-prefixed entry, so a
// folder's children never carry the prefix — so this one skip serves both.
func named(m map[string]node) []namedNode { func named(m map[string]node) []namedNode {
out := make([]namedNode, 0, len(m)) out := make([]namedNode, 0, len(m))
for _, name := range sortedNames(m) { for _, name := range sortedNames(m) {
+1 -2
View File
@@ -85,8 +85,7 @@ func linkRefs(root map[string]node) error {
// linkTemplateRefs binds one template's references against root, refusing one that names the // linkTemplateRefs binds one template's references against root, refusing one that names the
// category it sits in: a category is a unit, and a reference back into it describes a draw other // category it sits in: a category is a unit, and a reference back into it describes a draw other
// than the fields beside it. A template with no reference is left untouched, so an inline format // than the fields beside it.
// that references nothing costs only the refTokens scan.
func linkTemplateRefs(folder []string, path, category string, t *template, root map[string]node) error { func linkTemplateRefs(folder []string, path, category string, t *template, root map[string]node) error {
names := refTokens(t.format) names := refTokens(t.format)
if len(names) == 0 { if len(names) == 0 {
+9 -1
View File
@@ -196,7 +196,9 @@ by a `data-import/` script, as README goal 12 asks.
README. Carry the timezone weight's premise in with it: weighting by GeoNames city README. Carry the timezone weight's premise in with it: weighting by GeoNames city
population moved 300 seeded draws of `misc.territory[US].timezone` from 44 landing on population moved 300 seeded draws of `misc.territory[US].timezone` from 44 landing on
the four zones most Americans live in to 278, and dropped `America/Indiana/Petersburg` the four zones most Americans live in to 278, and dropped `America/Indiana/Petersburg`
(pop. 2,400) from 17 draws to 0. (pop. 2,400) from 17 draws to 0. Carry in the decision `linkTemplateRefs`'s doc holds
today, which no entry records: a category is a unit, so a reference back into it
describes a draw other than the fields beside it, which is what goal 3 asks for.
- Rewrite `CHANGELOG.md`'s `[Unreleased]` as what v0.1.0 holds: nothing has shipped, so - Rewrite `CHANGELOG.md`'s `[Unreleased]` as what v0.1.0 holds: nothing has shipped, so
"no longer paths", "where it used to fail" and "where it used to be an empty string" "no longer paths", "where it used to fail" and "where it used to be an empty string"
describe versions no reader can have installed. describe versions no reader can have installed.
@@ -237,6 +239,12 @@ because pairing a street with its exact postnummer rewrites shipped rows.
## Not release-bound ## Not release-bound
- Name goal 2's four criteria with the axes the panel scores, so a recorded score maps
back to the clause it came from: the goal spells them out in prose while `todo.md`
records `Navigation`, `Locality`, `Shape` and `Self-sufficiency`.
- Scope `AGENTS.md`'s `Hard tabs.` to the Go source, or drop it: `gofmt` already gates
Go at `Dockerfile:21`, and the shipped JSON under `data/` is two-space, so the rule as
written is one no Go file can break and every data file does.
- Make `gitea.larvit.se/larvit/fejkdata` a pull mirror of GitHub or retire it: - Make `gitea.larvit.se/larvit/fejkdata` a pull mirror of GitHub or retire it:
Gitea converts a repository to a mirror only by re-creating it, so until that runs Gitea converts a repository to a mirror only by re-creating it, so until that runs
the copy there is a second owner of one history and goes stale from this commit. the copy there is a second owner of one history and goes stale from this commit.