docs(review): drift pass over OVERRIDES/TESTING/template README (item 6b)
All checks were successful
Check / eval (push) Successful in 3m3s

Slice (b) of the docs review: every factual claim in the three docs
spot-checked against the tree (mkDefault sites, bind priority, CLI
keys, awww naming, preset/wallpaper counts, summer-night's light bar,
live-ISO monitor rule, CI workflow, QEMU GL flags, template steps) —
all held. Two gaps fixed: OVERRIDES §2 predated nomarchy.monitors and
never routed readers to it (added, plus a quick-reference row);
TESTING §1 didn't list the shell-syntax check that §1b says CI runs
(added bash -n).

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
Bernardo Magri
2026-07-04 19:36:01 +01:00
parent 56f1cc3fa9
commit b0b8a9a09b
4 changed files with 30 additions and 5 deletions

View File

@@ -26,10 +26,11 @@ next, in what order*.
ROADMAP § Full docs review. Done: the roadmap/backlog split (this file);
slice (a) option-surface reconcile — README tables fixed (9 gaps) and
the diff made permanent as the `option-docs` flake check (eval-walked
surface vs tables, catches stale rows too). Remaining slices:
- **(b) drift pass** over docs/OVERRIDES.md, docs/TESTING.md,
templates/downstream/README.md — read each against the current tree,
fix what lies.
surface vs tables, catches stale rows too); slice (b) drift pass over
docs/OVERRIDES.md, docs/TESTING.md, templates/downstream/README.md —
every factual claim spot-checked against the tree, all held; fixed the
two gaps (OVERRIDES now routes to `nomarchy.monitors`; TESTING §1 lists
the shell-syntax check its CI § claimed). Remaining slices:
- **(c) install/first-run story** read end to end (README install §§ +
template README as one narrative; fix the seams).
- **(d) recovery runbook** — short doc: desktop won't start → boot an

View File

@@ -17,6 +17,23 @@ Template:
---
## 2026-07-04 — docs slice (b): drift pass (iteration #14, item 6b)
- **Task:** BACKLOG NOW#6 slice (b) — OVERRIDES.md / TESTING.md /
templates/downstream/README.md vs the live tree.
- **Did:** spot-checked every factual claim: mkDefault sites (hyprland
behaviour knobs, ghostty paddings, waybar mainBar/style), bind-list
normal priority, `set ui.gapsOut` CLI key, awww(-daemon) naming,
21 presets, tokyo-night's 4 wallpapers, summer-night's light @fg bar,
live `,highres` mkForce, .gitea/workflows/check.yml, QEMU gl flags,
template `.#me` + ~/.nomarchy/NOMARCHY_PATH. All accurate. Fixed the
two real gaps: OVERRIDES §2 predated `nomarchy.monitors` (now routes
there + quick-ref row); TESTING §1 lacked the shell-syntax check §1b
claims CI runs (added `bash -n`).
- **Verified:** V0 (docs-only; flake untouched — check run pre-commit).
- **Pending:** slices (c) install story, (d) recovery runbook.
- **Next suggestion:** item 6 slice (c) or (d) — (d) is self-contained
and ships user value (the runbook).
## 2026-07-04 — docs slice (a): option-surface reconcile (iteration #13, item 6a)
- **Task:** BACKLOG NOW#6, first slice — README tables vs live options.
- **Did:** split item 6 into slices (ad) in BACKLOG. Reconciled: 9