Accuracy pass: preview_data registry, clock->rwb rename, missing sections
Architecture.md / Writing-a-Module.md:
- Document the new preview_data + PREVIEW_RENDERERS registry mechanism
(replaces the old single-consumer preview_tables field) - the actual
reason this wiki run happened. New subsection in Architecture.md,
new "Richer content in the preview panel" section in
Writing-a-Module.md with a worked example.
- Fixed every reference to a standalone clock.py module - it was
renamed to rwb.py once weather.py gave it a second thing to show,
months ago, but the wiki never caught up. Kept the teaching example
in Writing-a-Module.md (still pedagogically useful as a minimal
module) but corrected its false claims about a real shipped file.
- Module lists updated to include rwb/bars/sysmon, which existed
nowhere in Architecture.md or Writing-a-Module.md at all despite
being real, shipped, default-preset modules.
Config-Reference.md:
- Added scan/wifi_forget/wifi_connect_hidden/wifi_power_toggle to
[navigation.keys] - the entire WiFi/Bluetooth browsing key set was
completely undocumented.
- Replaced the stale [clock] section with [rwb] (correct section name)
plus a new [weather] section - weather config (lat/lon/geoclue/
ip_approx/name/code) didn't exist in the wiki at all despite being a
real, substantial opt-in feature.
- Fixed two false "not shown in the default layout preset" claims for
control and sysmon - both are actually placed in the default preset
today, contradicting what the page said.
Home.md: Status blurb updated to mention what's actually landed since
the last pass (sysmon, bars, the connectivity D-Bus agent overhaul),
not just control toggles + media.
Add Your-First-Contribution.md: a real onboarding path for code contributors
Prompted by an LLM council session on tuicc's architecture readability —
the council converged (independently across multiple advisors and peer
review) on: nobody has ever tested this repo's docs against a human
without full session context, and the gap isn't the code architecture
itself (praised independently by two advisors and an earlier external
review), it's that CLAUDE/NOTES/*.md and the wiki's existing pages serve
two different audiences without a clear entry point for either.
Getting-Started.md is explicitly "no coding required" (end-user setup).
CONTRIBUTING.md has solid PR-review rules but no walkthrough — it
assumes you already know your way around the codebase. Nothing filled
the actual gap: a first-time code contributor's path from "cloned the
repo" to "made one real change and saw it work."
New page walks through: a one-minute mental model (Provider abstraction,
registry-pattern modules, dataclass+function state convention — pointing
to Architecture.md for depth, not duplicating it), then a concrete,
zero-invented-scope worked example — uncommenting the already-shipped,
already-documented Night Light [[control.toggle]] example from
defaults/config.toml, reading it next to Config-Reference.md's contract,
running it for real (including deliberately trying it without gammastep
installed, to see the project's no-silent-failure principle fire for
real instead of just reading about it) — then writing one of your own
as practice, explicitly not meant to become a real PR (packaged toggle
examples are curated, not "add more" — see VISION.md's own reasoning).
Closes with what a genuinely good first real PR looks like (docs fix,
small module, new provider) and hands off to CONTRIBUTING.md.
Linked from Home.md (right after Getting-Started, as the other kind of
"getting started") and from CONTRIBUTING.md's own opening (a pointer
before the review rules, for anyone who isn't ready for them yet).
Home: bump date stamp, reflect control/media/StatusWorker in page blurbs
Home: link the new Summoning Tuicc page
Home: mention Quick install in the Getting Started blurb
Home: bump date stamp, reflect nav/lifecycle changes in page blurbs
- Architecture bullet: mention the persistent-process lifecycle,
reword spatial nav to past tense
- Keybindings bullet: mention vim keybinds, Tab/Shift+Tab-driven
- Status: date bump, add a summon/dismiss callout pointing at
Getting Started's keybind section
Home: Maintainer readthrough - rewriting parts for human audience xd