Restructure README.md into the canonical section set (closes #11)
All checks were successful
check / check (push) Successful in 9s
All checks were successful
check / check (push) Successful in 9s
REPO_POLICIES.md mandates a fixed set of README sections; this README predated the standard being applied here and had About / Contributing / Technical Details / Entrypoints / License instead. It is now a Description first line followed by Getting Started, Entrypoints, Rationale, Design, TODO, License, Author, with Author last. Nothing the old headings held was dropped: the list of what the site publishes moved under the Description, and the contribute contact and the local-preview instructions moved into Getting Started. Getting Started was written against the current Makefile rather than carried over from the old prose, which had drifted. There is no `make build` target, so the old "Build: `hugo`" instruction is now `make test`; "Local Development: `hugo server`" is now `make setup` then `make serve`, and `make setup` is what makes a fresh clone buildable at all since it installs the pinned Hugo. Two stale claims are fixed. The site is deployed by Gitea Actions to Cloudflare Pages, not "automatically via GitHub Actions". And the Entrypoints bullet for `script/fmt` still described the top-level-markdown-only scope that #12 replaced with `'**/*.md'` and `'**/*.css'`; the rest of that section was verified accurate against the scripts, including the `script/check` order and the `CHECK_EPOCH` guard that makes a bare `docker build .` fail closed. The License section body is deliberately untouched and no LICENSE file is added: that is #10's, which is blocked on the owner's choice of license. For the same reason the Description sentence omits the license clause the policy asks for; #10 completes both. The Design section's claims were checked against the tree rather than assumed: the vendored theme, the `readFile` inline of style.css in baseof.html, the `hugo --minify` output to `public/`, and the deploy workflow.
This commit is contained in:
20
TODO.md
20
TODO.md
@@ -28,6 +28,23 @@ remaining policy scaffold is otherwise complete.
|
||||
|
||||
# Completed Steps
|
||||
|
||||
- 2026-08-09: restructured `README.md` into the canonical section set (closes
|
||||
#11): a Description first line, then Getting Started, Entrypoints, Rationale,
|
||||
Design, TODO, License, Author. The non-standard About / Contributing /
|
||||
Technical Details headings are gone, but nothing they held was dropped — the
|
||||
bullet list of what the site publishes moved under the Description, the
|
||||
contribute contact and the local-preview instructions moved into Getting
|
||||
Started. Getting Started was written against the current `Makefile` rather
|
||||
than the old prose: there is no `make build` target, so the former "Build:
|
||||
`hugo`" instruction is now `make test`, and the former "Local Development:
|
||||
`hugo server`" is `make setup` then `make serve`. Two stale claims fixed: the
|
||||
site is deployed by Gitea Actions to Cloudflare Pages, not "GitHub Actions",
|
||||
and the Entrypoints bullet for `script/fmt` still described the
|
||||
top-level-markdown-only scope that #12 replaced with `'**/*.md'` and
|
||||
`'**/*.css'`. The License section body is deliberately untouched — it is owned
|
||||
by #10, which is blocked on the owner's choice of license, and the Description
|
||||
sentence is likewise missing the license clause the policy calls for until #10
|
||||
lands. Design section claims were verified against the tree, not assumed
|
||||
- 2026-08-09: widened the prettier gate from top-level markdown to `'**/*.md'`
|
||||
and `'**/*.css'` (closes #12). `themes/loravega/static/css/style.css` was
|
||||
never formatted or gated even though it is inlined into every page; it is now
|
||||
@@ -161,9 +178,6 @@ remaining policy scaffold is otherwise complete.
|
||||
here (#20)
|
||||
- Move the deploy container to a pinned node 22 so the wrangler pin can advance
|
||||
past 4.86.0 (#21)
|
||||
- Rework README.md into the standard sections: Description, Getting Started,
|
||||
Rationale, Design, TODO, License, Author (currently About, Contributing,
|
||||
Technical Details, License)
|
||||
- Sync the reformat of `REPO_POLICIES.md` back upstream to `prompts` so the
|
||||
canonical copy is clean under the shared prettier settings and future syncs
|
||||
are a straight byte copy
|
||||
|
||||
Reference in New Issue
Block a user