docs: factual-drift pass + i2c option docs (#47, #48)
Some checks failed
Check / eval (push) Has been cancelled
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:
@@ -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/*,
|
||||
|
||||
Reference in New Issue
Block a user