docs: factual-drift pass + i2c option docs (#47, #48)
Some checks failed
Check / eval (push) Has been cancelled

Fix documentation drift (each claim verified against code): theme count
21→24; waybar whole-swap lists (waybar.css=5 incl. neon-glass vs
waybar.jsonc parity=4 + boreal); idle "suspend 30"→"15 min battery-only";
Tailscale sudo→operator; hosts/live.nix "No installer yet" header; link
docs/MIGRATION.md + fix its placeholder URL; README layout tree
(+doctor/control-center/battery-notify); OVERRIDES swappy→satty; document
always-on home pieces. String fixes: keybind cheatsheet
nmtui→networkmanager_dmenu; complete nomarchy-menu usage string
(+doctor/firmware/controlcenter/rollback). Add README rows for
nomarchy.hardware.i2c.* (#48) — closes checks.option-docs.

Implemented by a worktree agent; diff reviewed and cherry-picked.
Verified V0 (flake check) + checks.option-docs green + V1 (HM build).

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
Bernardo Magri
2026-07-09 19:09:00 +01:00
parent 1ee17f6799
commit 97bf26a23f
11 changed files with 55 additions and 43 deletions

View File

@@ -114,32 +114,6 @@ Next slice: on hardware, run `hyprctl clients` while each is open, read
the real `class`, then append rules. Also revisit whether blueman/s-c-p
actually float once seen (regex tolerance for the `.…-wrapped` form).
### 47. Docs + string factual-drift pass (promoted 2026-07-09)
Pure docs (V0) plus two `.nix` string fixes (V1: HM build). One pass or split:
- **README/docs drift:** theme count **21 → 24** (`README.md`,
`docs/TESTING.md`, `templates/downstream/README.md`); waybar whole-swap
list → summer-day/summer-night/executive-slate/boreal/neon-glass (drop the
catppuccin/lumon/nord/retro-82 stubs); idle table "suspend **30**" →
**15 min battery-only** (`idle.nix`); Tailscale row `sudo tailscale up`
operator/no-sudo; `hosts/live.nix` header "No installer yet" → current;
CONVENTIONS parity list add **boreal**.
- **Secondary docs:** README layout tree add doctor/control-center/
battery-notify; link `docs/MIGRATION.md` from README nav + fix its
placeholder flake-init URL; OVERRIDES.md screenshot pipe swappy → **satty**.
- **Document always-on home pieces:** easyeffects/udiskie/cliphist ship with
no toggle by design — a short README note + override pointer.
- **String fixes (V1):** keybind cheatsheet `desc = "Network (nmtui)"`
networkmanager_dmenu (`keybinds.nix`); complete the `nomarchy-menu` usage
string (add doctor/controlcenter/rollback/firmware/…, `rofi.nix`).
Verify any documented command by running it.
### 48. Document `nomarchy.hardware.i2c.*` — close checks.option-docs (promoted 2026-07-09)
`nomarchy.hardware.i2c.enable` and `.ddcci` (`modules/nixos/hardware.nix`)
have no README table rows → `checks.option-docs` is red. Add rows (+ note the
effective default: option default `false` but distro `mkDefault true` for
ddcci in `modules/nixos/default.nix`). Optional template opt-in comment.
V0 — `checks.option-docs` verifies (pure runCommand, no VM).
### 49. Pure-contract `checks.*` batch — no VM (promoted 2026-07-09)
Add pure runCommand checks (all V0):
- Expand CI `py_compile` to **all** tracked `*.py` (compose-lock, tools/*,