Merge pull request 'docs(site): restore Categories table and fix markdown table syntax' (#95) from fix-categories-table into main

Reviewed-on: #95

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 `<CR>` 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 `<CR>` 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 `<CR>` 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):
 

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 `<CR>` 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

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 `<CR>` 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 `<CR>` 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):
 

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
 
 <LinkButton href="/10-installation/" icon="cloud-download" style="font-size: 1.25rem; padding: 1rem 1.5rem; margin-right: 1rem;">Install now</LinkButton>
-<LinkButton href="/reference/" variant="secondary" style="font-size: 1.125rem; padding: 0.85rem 1.25rem;">Function reference</LinkButton>
+<LinkButton href="/reference/" variant="secondary" style="font-size: 1.125rem; padding: 0.85rem 1.25rem;">Functions</LinkButton>
+<LinkButton href="/08-components-reference/" variant="secondary" style="font-size: 1.125rem; padding: 0.85rem 1.25rem;">Components</LinkButton>
 
 The configuration uses a structured file tree: