docs(options): README tables reconciled + permanent option-docs check (item 6a)
All checks were successful
Check / eval (push) Successful in 2m59s
All checks were successful
Check / eval (push) Successful in 2m59s
Slice (a) of the docs review: 9 undocumented nomarchy.* options got README rows or inline .leaf mentions (autoTimezone, camera IR-hide, intel.guc, amd.pstate/vaapi, package, system.stateFile, restic.paths). The diff is now a flake check: option names are eval-walked from the four option-declaring modules (config halves stay lazy) and compared to the tables by tools/check-option-docs.py — undocumented options and stale table rows both fail. Negative-tested against the pre-fix README (reports exactly the 9 gaps). Item 6 split into slices a–d in BACKLOG. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
@@ -849,6 +849,16 @@ how to override it. Items marked ✓ are shipped.
|
||||
your theme / essentials" flow (ties into the branding work).
|
||||
|
||||
## Known issues & follow-ups
|
||||
- ✓ **README option tables drift from the live surface** (docs review
|
||||
slice (a), 2026-07-04): a fresh reconcile found 9 undocumented options
|
||||
(autoTimezone, camera.hideIrSensor/irMatch, intel.guc, amd.pstate/
|
||||
vaapi, package, system.stateFile, restic.paths) — rows/mentions added,
|
||||
and the diff is now permanent: `checks.option-docs` walks the option
|
||||
names out of the four option-declaring modules at eval time (their
|
||||
lazy `config` halves never evaluate, so dummy args suffice) and
|
||||
requires each a table row — or a backticked `.leaf` mention for
|
||||
non-enable sub-knobs — plus flags table rows whose option no longer
|
||||
exists (tools/check-option-docs.py).
|
||||
- ✓ **swaync text invisible on summer-day** (Latitude QA, 2026-07-04):
|
||||
the themed CSS paired @subtext on @base, but palette roles are not
|
||||
uniform across themes — summer-day/flexoki-light use subtext as
|
||||
|
||||
Reference in New Issue
Block a user