Coherence: one component per idea, one spelling per word, one truth per claim

Claude-Session: https://claude.ai/code/session_01Ms2FbjQy31TVf3CEvQhGM8

config/dot/quickshell/manual/01-coming-from-another-desktop.md

@@ -49,5 +49,32 @@ clock in the middle and status on the right. There is still a dock. Volume
 and brightness keys still work, and still work on the lock screen. Copy and
 paste are unchanged. Your files are where you left them.
 
-GNOME Settings is still installed for the few panels Panama deliberately does
-not own, and Panama's own Settings hands off to it where that applies.
+## Where the settings went
+
+`Super + I` opens Panama's own Settings. The sidebar is where GNOME's panels
+ended up, and it is worth one read so you never have to hunt:
+
+| If you are looking for | It is under |
+|---|---|
+| Themes, wallpaper, fonts, text size, titlebars | Appearance |
+| The bar, the dock, Control Center, tiling, workspaces | Shell |
+| Resolution, scale, arrangement, night light | Displays |
+| Output and input devices, per-application volume | Sound |
+| Do Not Disturb, per-application rules, focus modes | Notifications & Focus |
+| Shortcuts, mouse and touchpad, dictation | Input |
+| Wi-Fi and VPN, the firewall, sharing, printers | Network & Sharing |
+| Default applications, autostart, gaming, Screen Intelligence | Applications |
+| The accounts on this machine, and online ones | Users & Accounts |
+| Permissions, saved passwords, what the machine remembers, SSH keys | Privacy & Security |
+| Battery, the lid, the power button, idle and lock timings | Power & Lock |
+| Magnifier, color filters, reduced motion, screen reader | Accessibility |
+| Updates, storage, snapshots, date and time, backups | System |
+
+Home is the page `Super + I` lands on. The search box above the sidebar
+searches the settings themselves rather than the page names, so typing what you
+want to change is usually faster than remembering which of those it lives in.
+
+GNOME Settings is still installed, and Panama's Settings opens it in exactly
+two places: adding an online account, which has to go through the provider's
+own dialog, and Digital wellbeing, which is the one panel of GNOME's that does
+something Panama does not.

config/dot/quickshell/manual/02-the-keyboard.md

@@ -58,3 +58,9 @@ one I have".
 Settings has a [Keyboard page](panama://settings/shortcuts), under Input, listing every bind, each of which
 can be reassigned. A rebind moves the shortcut and cannot change what it does, so
 there is no way to make a key do something unexpected by editing it.
+
+Shortcuts you invent live in the same list, in a **Custom** group above the
+rest. One of those names an application, a shell action or a window move rather
+than storing a command — for the same reason: what you are choosing is which
+key, not what it runs. A chord something already holds is refused rather than
+stolen, so a new shortcut can never quietly cost you an old one.

config/dot/quickshell/manual/03-windows-and-workspaces.md

@@ -28,9 +28,11 @@ follows you between workspaces. A floating window can be moved by holding
 
 ## Workspaces
 
-Ten of them, on `Alt + 1` through `Alt + 0`. `Alt + H` and `Alt + L` step
-between neighbours, and `Alt + Shift` plus a number sends the current window
-somewhere without following it.
+Ten you can jump straight to, on `Alt + 1` through `Alt + 0`, though they are
+created and destroyed as you use them rather than sitting there empty. `Alt + H`
+and `Alt + L` step between neighbours — right past the last one makes a new one,
+left from the first stays put — and `Alt + Shift` plus a number sends the
+current window somewhere without following it.
 
 On a machine with more than one display, workspaces belong to whichever
 screen has focus. If you would rather pin workspaces one through ten to your
@@ -41,6 +43,29 @@ How windows share the space — the layout, the master area, gaps and window
 edges — is Shell › Tiling. The workspace switches themselves, and the projects
 below, are Shell › Workspaces.
 
+## The touchpad
+
+Three fingers sideways moves between workspaces and follows your fingers as it
+goes; three fingers up opens the overview and three down closes it. Those are
+GNOME's gestures, reproduced, and they do not move.
+
+Four fingers are yours. Each of the four directions can be given a job — a shell
+action, a window or workspace move — from the same list your own shortcuts pick
+from, on Input › Mouse & Touchpad. Assigning one reloads the compositor, so
+expect a beat of black before it works. Unassigned directions are left alone
+rather than bound to nothing.
+
+## Rules for one application
+
+Some windows want the same treatment every time: the password manager should
+float, chat should open on workspace four, a picture viewer should not be
+resized to fill half the screen. **Application window rules** on Shell › Tiling is where that
+is written down. You pick an application and tick what should happen to it —
+float, center it, pin it to every workspace, give it a fixed size or a
+workspace to open on — rather than writing a match pattern. Panama's own
+surfaces cannot be targeted, and a rule with nothing ticked is refused rather
+than saved as a row you would wonder about later.
+
 ## Projects
 
 A project is the set of windows you open together: which applications, which

config/dot/quickshell/manual/04-when-something-breaks.md

@@ -10,8 +10,8 @@ From a terminal, the same check is `panama doctor`.
 
 ## The shell is gone
 
-If the bar and dock disappear, the Quickshell process died. **Restart Shell**
-from the launcher brings it back. If the launcher is also gone, press
+If the bar and dock disappear, the Quickshell process died. **Restart Desktop
+Shell** from the launcher brings it back. If the launcher is also gone, press
 `Super + Shift + R` for the fallback launcher, which depends on nothing but
 itself and exists for exactly this.
 
@@ -32,7 +32,7 @@ Settings has a [Displays page](panama://settings/displays). It opens on a pictur
 one display or several — and everything under that picture belongs to
 whichever one you have selected. Every change there reverts itself after
 fifteen seconds unless you confirm it, so a mode your monitor cannot show
-cannot strand you, and that covers colour, bit depth and mirroring as well as
+cannot strand you, and that covers color, bit depth and mirroring as well as
 resolution, scale and rotation. If you are already stranded, `hyprctl
 monitors` from a terminal shows what is applied.
 
@@ -45,6 +45,29 @@ labelled as an unverified claim, beside the real action.
 If you did not expect it at all, cancel. Nothing that needs privileges is
 harmed by being refused.
 
+## A button did nothing except change its wording
+
+That is the button working. Anything in Settings that removes something takes
+two presses: the first arms it, and the row then shows what is about to happen
+beside a **Keep** that backs out. The second press is the one that does it.
+
+Only one button in Settings is armed at a time, so arming a second one disarms
+the first, wherever it was.
+
+## The network I need is not in the list
+
+The Wi-Fi list is what is in range. **Saved networks**, further down
+[Connections](panama://settings/connectivity), is what this machine remembers,
+including the ones nowhere near you — which is where to tidy up a profile you
+want rid of, rather than waiting until you are standing next to it again. A
+network that broadcasts no name is joined with **Join a hidden network…**, at
+the bottom of the list.
+
+Opening a connection shows what it actually got — address, gateway, DNS — and
+is where you give it a fixed address instead when what it got does not work,
+or mark it metered so updates and large downloads wait until you are somewhere
+else.
+
 ## After an update, something is not right
 
 `panama migrate` applies repairs this machine has not had yet. It is safe to