From 11097e32de47aaad89a9865b3e8070cad0b43199 Mon Sep 17 00:00:00 2001 From: rootiest Date: Mon, 27 Jul 2026 23:47:40 -0400 Subject: [PATCH 1/3] docs(site): restore Categories table and fix markdown table syntax --- docs/manual/08-components-reference/index.md | 8 ++++++++ docs/manual/12-troubleshooting.md | 12 ++++++------ 2 files changed, 14 insertions(+), 6 deletions(-) diff --git a/docs/manual/08-components-reference/index.md b/docs/manual/08-components-reference/index.md index 0db32c8..8e8fc9f 100644 --- a/docs/manual/08-components-reference/index.md +++ b/docs/manual/08-components-reference/index.md @@ -10,3 +10,11 @@ The following tables detail every component in each category. Use this reference to understand exactly which behaviors change when you toggle a category variable. + Category Description + ────────────────────────────────────────────────────────────────────────── + C1 [Command Shadows](/08-components-reference/01-c1-command-shadows/) — Wraps destructive commands (`rm`, `cp`) to be safe by default + C2 [Startup Side-Effects](/08-components-reference/02-c2-startup-side-effects/) — Bootstraps Fisher, generates wrappers, auto-activates venvs + C3 [Overrides](/08-components-reference/03-c3-key-and-environment-overrides/) — Overrides `cd`, sets Vi mode, binds `` to `smart_enter` + C4 [Integrations](/08-components-reference/04-c4-terminal-and-tool-integration/) — Kitty/Wezterm integrations, starship hooks, fzf theme + C5 [Logging and Capture](/08-components-reference/05-c5-logging-and-capture/) — Session logs, command duration + C6 [Greeting & First-Run UI](/08-components-reference/06-c6-greeting-and-first-run-ui/) — Custom startup banner diff --git a/docs/manual/12-troubleshooting.md b/docs/manual/12-troubleshooting.md index 0223443..166fec2 100644 --- a/docs/manual/12-troubleshooting.md +++ b/docs/manual/12-troubleshooting.md @@ -208,12 +208,12 @@ This configuration groups its opinionated behaviors into six categories (C1–C6 Category Description ────────────────────────────────────────────────────────────────────────── - C1 | [Command Shadows](/08-components-reference/01-c1-command-shadows/) | Wraps destructive commands (`rm`, `cp`) to be safe by default | - C2 | [Startup Side-Effects](/08-components-reference/02-c2-startup-side-effects/) | Bootstraps Fisher, generates wrappers, auto-activates venvs | - C3 | [Overrides](/08-components-reference/03-c3-key-and-environment-overrides/) | Overrides `cd`, sets Vi mode, binds `` to `smart_enter` | - C4 | [Integrations](/08-components-reference/04-c4-terminal-and-tool-integration/) | Kitty/Wezterm integrations, starship hooks, fzf theme | - C5 | [Logging and Capture](/08-components-reference/05-c5-logging-and-capture/) | Session logs, command duration | - C6 | [Greeting & First-Run UI](/08-components-reference/06-c6-greeting-and-first-run-ui/) | Custom startup banner | + C1 [Command Shadows](/08-components-reference/01-c1-command-shadows/) — Wraps destructive commands (`rm`, `cp`) to be safe by default + C2 [Startup Side-Effects](/08-components-reference/02-c2-startup-side-effects/) — Bootstraps Fisher, generates wrappers, auto-activates venvs + C3 [Overrides](/08-components-reference/03-c3-key-and-environment-overrides/) — Overrides `cd`, sets Vi mode, binds `` to `smart_enter` + C4 [Integrations](/08-components-reference/04-c4-terminal-and-tool-integration/) — Kitty/Wezterm integrations, starship hooks, fzf theme + C5 [Logging and Capture](/08-components-reference/05-c5-logging-and-capture/) — Session logs, command duration + C6 [Greeting & First-Run UI](/08-components-reference/06-c6-greeting-and-first-run-ui/) — Custom startup banner Disable all opinionated features at once (Minimal Mode): From 2fb8e3718b3fd4a6b451f7ab110aad6b2d3d889f Mon Sep 17 00:00:00 2001 From: rootiest Date: Mon, 27 Jul 2026 23:58:10 -0400 Subject: [PATCH 2/3] docs(home): add button for components alongside functions button --- docs/manual/index.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/docs/manual/index.md b/docs/manual/index.md index a08a618..3017947 100644 --- a/docs/manual/index.md +++ b/docs/manual/index.md @@ -25,7 +25,8 @@ A production-grade Fish shell configuration targeting Fish 4.x. It provides: - Catppuccin Mocha color theme throughout Install now -Function reference +Functions +Components The configuration uses a structured file tree: From 429c407548afd2853aa389eba11094e1f60c5821 Mon Sep 17 00:00:00 2001 From: rootiest Date: Mon, 27 Jul 2026 23:58:42 -0400 Subject: [PATCH 3/3] chore(docs): rebuild config-help artifacts from SSoT --- docs/fish-config.md | 21 +++++++++++++++------ 1 file changed, 15 insertions(+), 6 deletions(-) diff --git a/docs/fish-config.md b/docs/fish-config.md index 162da0d..035f664 100644 --- a/docs/fish-config.md +++ b/docs/fish-config.md @@ -2835,6 +2835,15 @@ The following tables detail every component in each category. Use this reference to understand exactly which behaviors change when you toggle a category variable. + Category Description + ────────────────────────────────────────────────────────────────────────── + C1 Command Shadows — Wraps destructive commands (`rm`, `cp`) to be safe by default + C2 Startup Side-Effects — Bootstraps Fisher, generates wrappers, auto-activates venvs + C3 Overrides — Overrides `cd`, sets Vi mode, binds `` to `smart_enter` + C4 Integrations — Kitty/Wezterm integrations, starship hooks, fzf theme + C5 Logging and Capture — Session logs, command duration + C6 Greeting & First-Run UI — Custom startup banner + ## C1 — Command Shadows Disabling `__fish_config_op_aliases` restores standard system behavior for @@ -3483,12 +3492,12 @@ This configuration groups its opinionated behaviors into six categories (C1–C6 Category Description ────────────────────────────────────────────────────────────────────────── - C1 | Command Shadows | Wraps destructive commands (`rm`, `cp`) to be safe by default | - C2 | Startup Side-Effects | Bootstraps Fisher, generates wrappers, auto-activates venvs | - C3 | Overrides | Overrides `cd`, sets Vi mode, binds `` to `smart_enter` | - C4 | Integrations | Kitty/Wezterm integrations, starship hooks, fzf theme | - C5 | Logging and Capture | Session logs, command duration | - C6 | Greeting & First-Run UI | Custom startup banner | + C1 Command Shadows — Wraps destructive commands (`rm`, `cp`) to be safe by default + C2 Startup Side-Effects — Bootstraps Fisher, generates wrappers, auto-activates venvs + C3 Overrides — Overrides `cd`, sets Vi mode, binds `` to `smart_enter` + C4 Integrations — Kitty/Wezterm integrations, starship hooks, fzf theme + C5 Logging and Capture — Session logs, command duration + C6 Greeting & First-Run UI — Custom startup banner Disable all opinionated features at once (Minimal Mode):