docs(index): full audit of the config-help keyword index

Cover the ~50 previously-unindexed headings (function reference entries
like play-media, steam-dl, bd-pull, cffetch/ffetch, config-toggle, dops,
rand_string, fish_prompt/fish_mode_prompt/fish_right_prompt, lD, mv, p,
fast/fast-cli, gip4/gip6, fzf-update, sponge_filter_secrets,
fzf_configure_bindings, ld; the C1-C6 component sub-category headings
filesystem/network/monitor/shell-tools/dev-tools,
plugin-management/pkg-wrappers/venv/telemetry/sync,
key-bindings/environment/prompt, terminal-abbrs/window-mgmt/
notifications/history-logs/pkg-upgrade, terminal-capture/
multiplexer-capture/pkg-logs, first-run/greeting-message; plus
Config Variables' "Other", the Integrations "Scrollback History", the
dependency catalog's Optional/Terminal Emulators tiers, the C0/always
override note, and "Reading the source directly").

Expanded aliases for existing headings: play-media also reachable as
video/audio/mpv/vlc, steam-dl as steam, cffetch/ffetch share fetch/
fastfetch/neofetch/sysinfo, rand_string as random/password/randomword,
gip4/gip6 as ipv4/ipv6, dops as docker-ps, ld as lazydocker, bd-pull as
beads, fast-cli as speedtest, sponge_filter_secrets as secret-filter.

Fixed two pre-existing duplicate normalized keys (key-bindings/
keybindings and man-page/manpage both collapsed to a single entry) and
repointed config-toggle from the generic config-settings heading to its
own dedicated "### config-toggle" heading now that one exists.

Judgment calls on ambiguous/repeated heading text (left unindexed, or
indexed via a distinguishing keyword instead of the literal name):
- "### Sub-categories" repeats 7 times (once per opinionated-components
  overview and once per C1-C6 page); an index entry pointing at that
  text always resolves to the first occurrence, so none of the 7 are
  indexed under that name. Each parent (C1-C6, and the Minimal Mode
  section) already has its own keyword.
- "### search" appears twice: the pkg search subcommand (kept, existing
  `search` key) and the C1 command-shadow sub-category. The C1 one
  isn't separately reachable for the same reason.
- "## Integrations" appears twice (Section 1 integrations writeup and
  the Dependency Catalog's Integrations tier table); only the first
  (already indexed) is reachable.
- Where a C1-C6 sub-category heading text collides after normalization
  with an existing higher-value keyword (key-bindings, network,
  notifications, venv), the new entry uses a distinguishing keyword
  (bindings-toggle, network-shadow, notifications-toggle, venv-toggle)
  instead of contesting the existing one.
- `prompt` now points at the fuller "## Prompt and Theme" section
  rather than the one-line C3 sub-category blurb; the latter is
  reachable via `prompt-toggle`.
This commit is contained in:
2026-08-31 21:56:15 -04:00
parent 1aef0ffca8
commit 618ce00f9e
+83 -10
View File
@@ -27,6 +27,7 @@ scrollback=## Scrollback History
__fish_scrollback_history_dir=## Scrollback History __fish_scrollback_history_dir=## Scrollback History
__fish_scrollback_history_max_files=## Scrollback History __fish_scrollback_history_max_files=## Scrollback History
scrollback-dir=## Scrollback History scrollback-dir=## Scrollback History
misc-vars=## Other
# ── Section 2: PATH ─────────────────────────────────────────── # ── Section 2: PATH ───────────────────────────────────────────
path=# 2. PATH SETUP path=# 2. PATH SETUP
@@ -34,7 +35,6 @@ path=# 2. PATH SETUP
# ── Section 3: Key Bindings ─────────────────────────────────── # ── Section 3: Key Bindings ───────────────────────────────────
keybindings=# 3. KEY BINDINGS keybindings=# 3. KEY BINDINGS
bindings=# 3. KEY BINDINGS bindings=# 3. KEY BINDINGS
key-bindings=# 3. KEY BINDINGS
keys=# 3. KEY BINDINGS keys=# 3. KEY BINDINGS
fzf-bindings=## FZF Bindings (bundled from PatrickF1/fzf.fish) fzf-bindings=## FZF Bindings (bundled from PatrickF1/fzf.fish)
fzf=## FZF Bindings (bundled from PatrickF1/fzf.fish) fzf=## FZF Bindings (bundled from PatrickF1/fzf.fish)
@@ -67,6 +67,8 @@ cat=### cat
copy=### copy copy=### copy
du=### du du=### du
dusize=### dusize dusize=### dusize
dirs=### lD
lsdirs=### lD
ls=### ls ls=### ls
lsr=### lsr lsr=### lsr
lss=### lss lss=### lss
@@ -76,6 +78,7 @@ ltr=### ltr
lx=### lx lx=### lx
mkdir=### mkdir mkdir=### mkdir
mkcd=### mkcd mkcd=### mkcd
mv=### mv
poke=### poke poke=### poke
rm=### rm rm=### rm
rg=### rg rg=### rg
@@ -110,6 +113,7 @@ parur=### parur
deps=## 5.6 Dependency Management deps=## 5.6 Dependency Management
fish-deps=### fish-deps fish-deps=### fish-deps
check-deps=### check_fish_deps check-deps=### check_fish_deps
fzf-update=### fzf-update
system=## 5.7 System and Monitoring system=## 5.7 System and Monitoring
top=### top top=### top
swapstat=### swapstat swapstat=### swapstat
@@ -125,19 +129,33 @@ split=### split
spwin=### spwin spwin=### spwin
detach=### detach detach=### detach
bkg=### bkg bkg=### bkg
fish-mode-prompt=### fish_mode_prompt
fish-prompt=### fish_prompt
fish-right-prompt=### fish_right_prompt
right-prompt=### fish_right_prompt
jobrunner=### jobrunner jobrunner=### jobrunner
jr=### jr jr=### jr
ssh=### ssh ssh=### ssh
clipboard=## 5.9 Clipboard clipboard=## 5.9 Clipboard
copy-fn=### y copy-fn=### y
p=### p
paste=### paste paste=### paste
network=## 5.10 Network network=## 5.10 Network
fast=### fast
fast-cli=### fast-cli
speedtest=### fast-cli
gip=### gip gip=### gip
gip4=### gip4
ipv4=### gip4
gip6=### gip6
ipv6=### gip6
ping=### ping ping=### ping
qr=### qr qr=### qr
logging=## 5.11 Pager and Logging logging=## 5.11 Pager and Logging
logs=### logs logs=### logs
smart-exit=### smart_exit smart-exit=### smart_exit
sponge-filter-secrets=### sponge_filter_secrets
secret-filter=### sponge_filter_secrets
ai=## 5.12 AI and Developer Tools ai=## 5.12 AI and Developer Tools
antigravity-ide=### antigravity-ide antigravity-ide=### antigravity-ide
agy=### agy agy=### agy
@@ -152,28 +170,52 @@ devlogs=### agents-init
claude-cli=### claude claude-cli=### claude
claude-docs=### claude-docs claude-docs=### claude-docs
claude-pr=### claude-pr claude-pr=### claude-pr
dops=### dops
docker-ps=### dops
qc=### qc qc=### qc
quick-chat=### qc quick-chat=### qc
aichat=### qc aichat=### qc
superpowers=### superpowers superpowers=### superpowers
media=## 5.13 Media and Utilities media=## 5.13 Media and Utilities
dng2avif=### dng2avif dng2avif=### dng2avif
play-media=### play-media
video=### play-media
audio=### play-media
mpv=### play-media
vlc=### play-media
spark=### spark spark=### spark
steam-dl=### steam-dl
steam=### steam-dl
yt-dlp=### yt-dlp yt-dlp=### yt-dlp
miscfns=## 5.14 Miscellaneous miscfns=## 5.14 Miscellaneous
bash=### bash
bd-pull=### bd-pull
beads=### bd-pull
cffetch=### cffetch
fastfetch=### ffetch
neofetch=### cffetch
sysinfo=### cffetch
cheat=### cheat
config-help=### config-help config-help=### config-help
config-update=### config-update
config-settings=### config-settings
config-toggle=### config-toggle
toggle=### config-settings
dockup=### dockup
fetch=### cffetch
ffetch=### ffetch
fzf_configure_bindings=### fzf_configure_bindings
joplin=### joplin
ld=### ld
lazydocker=### ld
open-url=### open-url open-url=### open-url
url-open=### open-url url-open=### open-url
repo-open=### repo-open repo-open=### repo-open
open-repo=### repo-open open-repo=### repo-open
config-update=### config-update rand_string=### rand_string
config-settings=### config-settings random=### rand_string
config-toggle=### config-settings password=### rand_string
toggle=### config-settings randomword=### rand_string
bash=### bash
cheat=### cheat
dockup=### dockup
joplin=### joplin
replay=### replay replay=### replay
tmux=### tmux-clean tmux=### tmux-clean
wake-lock=### wake-lock wake-lock=### wake-lock
@@ -208,6 +250,7 @@ pager-hierarchy=## Pager Hierarchy
shell-aliases=## 4.11 Shell Aliases shell-aliases=## 4.11 Shell Aliases
kitty-logging=### kitty-logging kitty-logging=### kitty-logging
watcher=### kitty-logging watcher=### kitty-logging
kitty-scrollback=### Scrollback History
# ── Section 6: Dependency Catalog ──────────────────────────── # ── Section 6: Dependency Catalog ────────────────────────────
catalog=# 6. DEPENDENCY CATALOG catalog=# 6. DEPENDENCY CATALOG
@@ -215,6 +258,8 @@ deps-catalog=# 6. DEPENDENCY CATALOG
required=## Required required=## Required
integrations=## Integrations integrations=## Integrations
recommended=## Recommended recommended=## Recommended
optional-deps=## Optional
terminal-emulators=## Terminal Emulators
install-methods=## Install Methods install-methods=## Install Methods
# ── Section 7: Customization ────────────────────────────────── # ── Section 7: Customization ──────────────────────────────────
@@ -233,17 +278,38 @@ opt-out=## Opinionated Components (Minimal Mode)
toggles=## Opinionated Components (Minimal Mode) toggles=## Opinionated Components (Minimal Mode)
component-reference=# 8. COMPONENTS REFERENCE component-reference=# 8. COMPONENTS REFERENCE
components=# 8. COMPONENTS REFERENCE components=# 8. COMPONENTS REFERENCE
c0=## Per-function overrides: `C0`/`always`
always-tag=## Per-function overrides: `C0`/`always`
c1=## C1 — Command Shadows c1=## C1 — Command Shadows
command-shadows=## C1 — Command Shadows command-shadows=## C1 — Command Shadows
aliases-detail=## C1 — Command Shadows aliases-detail=## C1 — Command Shadows
filesystem=### filesystem
network-shadow=### network
monitor=### monitor
shell-tools=### shell-tools
dev-tools=### dev-tools
c2=## C2 — Startup Side-Effects c2=## C2 — Startup Side-Effects
autoexec=## C2 — Startup Side-Effects autoexec=## C2 — Startup Side-Effects
startup=## C2 — Startup Side-Effects startup=## C2 — Startup Side-Effects
plugin-management=### plugin-management
pkg-wrappers=### pkg-wrappers
venv-toggle=### venv
telemetry=### telemetry
sync=### sync
c3=## C3 — Key and Environment Overrides c3=## C3 — Key and Environment Overrides
overrides-detail=## C3 — Key and Environment Overrides overrides-detail=## C3 — Key and Environment Overrides
bang-bang=## C3 — Key and Environment Overrides bang-bang=## C3 — Key and Environment Overrides
bindings-toggle=### key-bindings
environment=### environment
prompt-toggle=### prompt
c4=## C4 — Terminal and Tool Integration c4=## C4 — Terminal and Tool Integration
integrations-detail=## C4 — Terminal and Tool Integration integrations-detail=## C4 — Terminal and Tool Integration
terminal-abbrs=### terminal-abbrs
window-mgmt=### window-mgmt
window-management=### window-mgmt
notifications-toggle=### notifications
history-logs=### history-logs
pkg-upgrade=### pkg-upgrade
c5=## C5 — Logging and Capture c5=## C5 — Logging and Capture
logging-detail=## C5 — Logging and Capture logging-detail=## C5 — Logging and Capture
logging-sentinel=## C5 — Logging and Capture logging-sentinel=## C5 — Logging and Capture
@@ -252,11 +318,17 @@ zellij-logging=## C5 — Logging and Capture
tmux-logging=## C5 — Logging and Capture tmux-logging=## C5 — Logging and Capture
pipe-pane=## C5 — Logging and Capture pipe-pane=## C5 — Logging and Capture
dump-screen=## C5 — Logging and Capture dump-screen=## C5 — Logging and Capture
terminal-capture=### terminal-capture
multiplexer-capture=### multiplexer-capture
pkg-logs=### pkg-logs
c6=## C6 — Greeting and First-Run UI c6=## C6 — Greeting and First-Run UI
greeting=## C6 — Greeting and First-Run UI greeting=## C6 — Greeting and First-Run UI
first-run=### first-run
greeting-message=### greeting-message
# ── Prompt and Theme ────────────────────────────────────────── # ── Prompt and Theme ──────────────────────────────────────────
prompt-theme=## Prompt and Theme prompt-theme=## Prompt and Theme
prompt=## Prompt and Theme
starship=### Starship starship=### Starship
fallback-prompt=### Catppuccin Fallback Prompt fallback-prompt=### Catppuccin Fallback Prompt
catppuccin-prompt=### Catppuccin Fallback Prompt catppuccin-prompt=### Catppuccin Fallback Prompt
@@ -316,11 +388,12 @@ minimal-trouble=## What's with the C1-C6 stuff?
viewing=# 13. VIEWING THIS MANUAL viewing=# 13. VIEWING THIS MANUAL
manual=# 13. VIEWING THIS MANUAL manual=# 13. VIEWING THIS MANUAL
ov=## In the terminal ov=## In the terminal
man-page=## As a man page
manpage=## As a man page manpage=## As a man page
jump=## In the terminal jump=## In the terminal
html=## The documentation website html=## The documentation website
browser=## The documentation website browser=## The documentation website
site=## The documentation website site=## The documentation website
source=## Reading the source directly
raw-source=## Reading the source directly