Publish topic guides to the wiki and document tabbed windows

Publish the guides from this repository to the GitHub Wiki. Organize them into Usage, Configuration and Development, with 15 separate configuration topics and redirects for the former website guide URLs.

Add a tabbed-windows guide covering grouping, switching tabs and taking windows out. Document the scrolling indicator's defaults and limits, and link the guide from the README, shortcuts and IPC pages. Update from main, including the latest tabbed-layout changes.

Separate Activities setup, configuration and publishing documentation. Review the guide prose with the unslop skill, keeping existing examples and heading links. The wiki workflow uses GitHub's built-in token to publish documentation changes on main.

Validation:

- 20 documentation tests pass, including README links and Activities/tab-indicator field coverage.
- The publisher builds 46 wiki pages; the site build and Python syntax checks pass.
- All 115 code examples from main are preserved.
- The Python suite passes: 90 tests passed and 31 opt-in integration tests skipped, with the system GI module available.
This commit is contained in:
Samuel Onoja authored and GitHub committed 2026-10-13 00:32:23 +01:00
1 parent eaeabebe73
commit eb84104940
37 files changed
+2178 -1510

No files matched your search

+6 -6
View File
@@ -1,9 +1,5 @@
# feresectl and IPC events
`feresectl keybindings` lists the active binding mode's shortcuts. Outside a
mode it lists the configured default shortcuts. Escape is always available to
leave a mode; see [Binding modes](configuration.md#binding-modes).
`feresectl` controls a running Ferese session. Run `feresectl --help` for commands
and `feresectl COMMAND --help` for arguments.
@@ -27,6 +23,10 @@ feresectl media
feresectl activity list
```
`feresectl keybindings` lists the active binding mode's shortcuts. Outside a
mode it lists the configured default shortcuts. Escape is always available to
leave a mode; see [Binding modes](configuration/bindings.md#binding-modes).
The `get-*` spellings remain hidden aliases for the corresponding queries and
print a deprecation warning on stderr. They use the same output rules: scripts
that previously parsed their JSON must add `-j`. New scripts should use the
@@ -59,7 +59,7 @@ these actions.
`toggle-column-tabbed` changes a scrolling column between stacked rows and tabs.
In either layout, `join-tab left|right|up|down` joins the focused window to a
neighbouring tab group. `next-tab` and `previous-tab` switch tabs, and `leave-tab`
splits the focused tab out. See [Commands and bindings](configuration.md#commands-and-bindings)
splits the focused tab out. See [Tabbed windows](tabbed-windows.md)
for grouping behavior and shortcuts.
## Live Activities
@@ -67,7 +67,7 @@ for grouping behavior and shortcuts.
Use `feresectl run --title "Tests" -- cargo test` to publish a command's lifetime,
or `feresectl activity start`, `update`, `end` and `cancel` to publish status from
an integration. The [Live Activities guide](activities.md) covers setup and
examples; its [publisher section](activities.md#publisher-ownership-and-lifecycle) explains ownership,
examples; the [publishing guide](development/activities.md#publisher-ownership-and-lifecycle) explains ownership,
leases and the `activity-publish`, `activity-get` and `activity-watch` commands.
`feresectl activity setup --config PATH` updates a local config for shell