Simplify documentation and website; expand shortcut guides

docs/desktop-widgets.md

@@ -1,13 +1,8 @@
 # Desktop widgets
 
-The shell's desktop clock sits above the wallpaper and behind normal windows.
-Drag the clock to reposition it; it reserves no workspace space.
-All desktop widgets share dragging: grab the clock or a note's title. Release
-to save the position, or press Escape to cancel.
-Dragging stops at other visible widgets on the same output; edges can slide
-along each other. Disabled widgets and widgets on other outputs do not block it.
-Each matching output gets a small, transparent surface—not a full-screen canvas.
-Lock-screen rendering remains separate and does not expose the desktop clock.
+Clock and sticky-note widgets sit above the wallpaper and behind windows.
+Drag the clock or a note's title to move it. Release to save, or press Escape to
+cancel. Widgets stop at each other's edges on the same display.
 
 Enable it in Settings → Desktop widgets or in your Ferese config:
 
@@ -42,42 +37,40 @@ desktop-widgets {
 Positions: `top_left`, `top_center`, `top_right`, `center_left`, `center`,
 `center_right`, `bottom_left`, `bottom_center`, `bottom_right`.
 Margins affect anchored axes only: a centered horizontal position ignores
-`margin_x`; a centered vertical position ignores `margin_y`.
+`margin-x`; a centered vertical position ignores `margin-y`.
 All geometry and text sizes use logical pixels and follow the output's scale.
 Increase the widget width/height for longer formats or larger text.
 
-Pixel is the default clock style: heavy hours above minutes, alternating theme colors, and a small plain date above. Its bundled Cantarell display font can be replaced with the font selector. Minimal retains the plain time/date layout. Pixel zero-pads hours and hides am/pm for the stacked display. Formats with seconds or additional text retain their full formatted label on one line. Both styles shrink time text to fit smaller widget dimensions; an explicit text color overrides the alternating colors.
+Choose **Pixel** for stacked hours and minutes with alternating theme colors,
+or **Minimal** for a plain time/date layout. Pixel zero-pads hours and hides am/pm.
+Formats containing seconds or extra text use a single line. Both styles shrink
+time text to fit. Select a different font in Settings, or set `font-family`.
 
-Saving reloads appearance and labels live. Placement, size, output filters and
-enable/disable changes recreate only clock surfaces; normal windows and the bar
-remain intact. Disconnecting an output destroys its clock; reconnecting creates
-one if its name matches the filter. Invalid configuration keeps the last working
-configuration. Theme changes apply to colors/fonts that have no explicit override.
-
-Formatting uses [Jiff's strftime-compatible formats](https://docs.rs/jiff/latest/jiff/fmt/strtime/index.html).
-Seconds update on the shell's existing timer. Without seconds, unchanged labels
-produce no additional clock buffer damage; there is no widget animation loop.
-Widget placement can be changed by dragging or through Settings and KDL.
-Sticky notes also support editing directly on the desktop.
+Changes apply live. Colors and fonts follow the theme unless overridden.
+Formatting uses [strftime-compatible formats](https://docs.rs/jiff/latest/jiff/fmt/strtime/index.html).
+Use `%H:%M` for 24-hour time or `%-I:%M %p` for 12-hour time.
 
 ## Clock limits
 
+Clock and note corners follow the shared shell radius. Their `radius` fields
+are accepted for compatibility but do not override it.
+
 All clock keys are optional. The example enables the clock (disabled by default);
 the other values illustrate defaults or their empty-string equivalents.
-`outputs` is an array of strings; `enabled`, `bold`, `show_date`, `lowercase` are
+`outputs` is an array of strings; `enabled`, `bold`, `show-date`, `lowercase` are
 booleans; `width`, `height`, and margins are integers. Other sizes/opacity are numbers.
 
 | Fields | Accepted range |
 | --- | --- |
 | `width`, `height` | 64–1600, 32–800 |
-| `margin_x`, `margin_y` | 0–8192 |
-| `time_size`, `date_size` | 8–240, 8–96 |
+| `margin-x`, `margin-y` | 0–8192 |
+| `time-size`, `date-size` | 8–240, 8–96 |
 | `opacity` | 0–1 |
 | `gap`, `padding`, `radius` | 0–64, 0–64, 0–128 |
-| `font_family`, `time_format`, `date_format` | At most 128 bytes each |
+| `font-family`, `time-format`, `date-format` | At most 128 bytes each |
 | `outputs` | At most 32 exact output names, each 1–128 bytes |
 
-Formats must be valid; `time_zone` must be empty or a recognized IANA name.
+Formats must be valid; `time-zone` must be empty or a recognized IANA name.
 Colors are empty (inherit), `#RRGGBB` or `#RRGGBBAA`; all numeric values must be finite.
 
 ## Sticky notes
@@ -87,7 +80,8 @@ click Edit for its multiline editor, then Done to finish. Text autosaves after
 500 ms without typing. Escape cancels a drag or finishes editing. Position saves
 on release; dragging changes the anchor to `top_left` and saves pixel margins.
 Title, size and style are also editable in Settings. Notes persist in the config.
-Choose each note’s font in Settings using the installed-font dropdown or enter a family name manually. Default font inherits the interface font. In KDL, use `font-family "Comfortaa"` inside the `note` node.
+Choose a note’s font in Settings or set `font-family "Comfortaa"` in its `note`
+node. Without an override, notes use the interface font.
 
 These are plain-text notes, not Markdown or HTML.
 
@@ -99,9 +93,7 @@ desktop-widgets {
 
 Repeat the `note` node for additional notes; IDs must be unique. Cards stay behind windows
 and take keyboard focus only when clicked. Set `interactive #false` for a fully
-click-through card. Long text wraps; increase height if needed. Notes have no idle
-animation loop. Clock and notes share a compact drag preview moved by the
-compositor, not an output-sized canvas. It is released when dragging ends.
+click-through card. Long text wraps; increase height if needed.
 
 | Key | Type | Default / accepted values |
 | --- | --- | --- |
@@ -112,10 +104,10 @@ compositor, not an output-sized canvas. It is released when dragging ends.
 | `text` | string | `""`; multiline plain text, maximum 16 KiB |
 | `outputs` | string array | `[]` means all; at most 32 exact names, each 1–128 bytes |
 | `anchor` | string | `"top_right"`; same nine positions as clock |
-| `margin_x`, `margin_y` | integer | `48`, `80`; 0–8192; anchored edges only |
+| `margin-x`, `margin-y` | integer | `48`, `80`; 0–8192; anchored edges only |
 | `width`, `height` | integer | `320`, `240`; 120–1200, 80–1200 |
-| `font_family` | string | omitted/empty follows desktop font; maximum 128 bytes |
-| `text_size`, `title_size` | number | `16`, `18`; 8–96 |
+| `font-family` | string | omitted/empty follows desktop font; maximum 128 bytes |
+| `text-size`, `title-size` | number | `16`, `18`; 8–96 |
 | `color` | string | omitted/empty/`"theme"` follows primary text; or hex color |
 | `background` | string | omitted/`"theme"` follows surface base; empty is transparent; or hex color |
 | `opacity` | number | `0.9`; 0–1, multiplies text/background alpha |