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 6 additions and 6 deletions
Showing only changes of commit bd1dcb7fc8 - Show all commits
+1 -1
View File
@@ -114,4 +114,4 @@ In [docs/decisions.md](docs/decisions.md):
- comprehension floor: every dimension and the overall at 7.0 or above; item 5 scores the restructure, which ships unscored: every `{…}` drawing afresh, the moves into `internal/`, and items 101, 102 and 104 to 106 - comprehension floor: every dimension and the overall at 7.0 or above; item 5 scores the restructure, which ships unscored: every `{…}` drawing afresh, the moves into `internal/`, and items 101, 102 and 104 to 106
- The template engine stays the root package until item 107; what reads no engine type sits in `internal/`, and items 101 and 102 move a table's rows there - The template engine stays the root package until item 107; what reads no engine type sits in `internal/`, and items 101 and 102 move a table's rows there
- Goal 5.1's `{…}` covers `{{`, `}}` and a lone `}`, so the goal names no escape - Goal 5.1's `{…}` covers `{{`, `}}` and a lone `}`, so the goal names no escape
- Goal 7.2's "no escaping" means a template needs no special character beyond `{` and `}` - Goal 7.2 aims for a first template that can be written with no escape, not for templates that never need one
+5 -5
View File
@@ -850,9 +850,9 @@ the README's Format string section states. The maintainer ruled the escape impli
goal: doubled braces and a lone `}` belong to the `{…}` syntax, so the goal names no escape and goal: doubled braces and a lone `}` belong to the `{…}` syntax, so the goal names no escape and
a lone `}` stays an error. Valid while a template escapes a brace by doubling it. a lone `}` stays an error. Valid while a template escapes a brace by doubling it.
## Goal 7.2's "no escaping" means a template needs no special character beyond `{` and `}` ## Goal 7.2 aims for a first template that can be written with no escape, not for templates that never need one
2026-10-05, Lilleman auf Larv. Serves goal 7.2. The maintainer reads "no escaping" as: a 2026-10-05, Lilleman auf Larv. Serves goal 7.2. A goal is an aim, not a promise: it is enough
template can be written with no special character other than `{` and `}`. A literal brace that a first template can be written with no escape and no options, as `{first} {last}` is. A
written `{{` or `}}` therefore meets the goal. Valid while `{` and `}` are the only template that wants a literal brace writes `{{` or `}}`, and that does not work against the
characters with a meaning outside a `{…}` token. goal. Valid while a template needs an escape only to print a brace.