From 38bb4fefb9d39241a15e5437629ea4afa3db8866 Mon Sep 17 00:00:00 2001
From: Vincent Koc <vincentkoc@ieee.org>
Date: Thu, 23 Apr 2026 20:48:29 -0700
Subject: [PATCH] docs(help): restructure Help tab sidebar and shorten FAQ /
 live-tests titles

---
 docs/docs.json             | 51 +++++++++++++-------------------------
 docs/help/faq-first-run.md |  3 ++-
 docs/help/faq-models.md    |  3 ++-
 docs/help/testing-live.md  |  3 ++-
 4 files changed, 23 insertions(+), 37 deletions(-)

diff --git a/docs/docs.json b/docs/docs.json
index 90310940230..76542abc785 100644
--- a/docs/docs.json
+++ b/docs/docs.json
@@ -1004,6 +1004,10 @@
                   "install/uninstall",
                   "install/development-channels"
                 ]
+              },
+              {
+                "group": "Advanced setup",
+                "pages": ["start/setup", "pi-dev"]
               }
             ]
           },
@@ -1580,6 +1584,7 @@
                   "reference/transcript-hygiene",
                   "reference/memory-config",
                   "reference/rich-output-protocol",
+                  "reference/session-management-compaction",
                   "date-time"
                 ]
               },
@@ -1598,8 +1603,8 @@
                 "pages": ["reference/credits"]
               },
               {
-                "group": "Release policy",
-                "pages": ["reference/RELEASING", "reference/test"]
+                "group": "Release and CI",
+                "pages": ["reference/RELEASING", "reference/test", "ci"]
               }
             ]
           },
@@ -1607,46 +1612,24 @@
             "tab": "Help",
             "groups": [
               {
-                "group": "Help",
-                "pages": [
-                  "help/index",
-                  "help/troubleshooting",
-                  "help/faq",
-                  "help/faq-first-run",
-                  "help/faq-models"
-                ]
+                "group": "Start here",
+                "pages": ["help/index", "help/troubleshooting", "help/debugging"]
               },
               {
-                "group": "Community",
-                "pages": ["start/lore"]
+                "group": "FAQ",
+                "pages": ["help/faq", "help/faq-first-run", "help/faq-models"]
               },
               {
-                "group": "Environment and debugging",
-                "pages": [
-                  "help/environment",
-                  "help/debugging",
-                  "help/testing",
-                  "help/testing-live",
-                  "help/scripts",
-                  "debug/node-issue",
-                  "diagnostics/flags"
-                ]
+                "group": "Testing",
+                "pages": ["help/testing", "help/testing-live", "help/scripts"]
               },
               {
-                "group": "Compaction internals",
-                "pages": ["reference/session-management-compaction"]
+                "group": "Diagnostics",
+                "pages": ["help/environment", "diagnostics/flags", "debug/node-issue"]
               },
               {
-                "group": "Developer setup",
-                "pages": ["start/setup", "pi-dev"]
-              },
-              {
-                "group": "Contributing",
-                "pages": ["ci"]
-              },
-              {
-                "group": "Docs meta",
-                "pages": ["start/hubs", "start/docs-directory"]
+                "group": "Community and meta",
+                "pages": ["start/lore", "start/hubs", "start/docs-directory"]
               }
             ]
           }
diff --git a/docs/help/faq-first-run.md b/docs/help/faq-first-run.md
index d5cedee9290..6ab373d60b4 100644
--- a/docs/help/faq-first-run.md
+++ b/docs/help/faq-first-run.md
@@ -4,7 +4,8 @@ read_when:
   - New install, onboarding stuck, or first-run errors
   - Choosing auth and provider subscriptions
   - Cannot access docs.openclaw.ai, cannot open dashboard, install stuck
-title: "FAQ — quick start and first-run setup"
+title: "FAQ: first-run setup"
+sidebarTitle: "First-run FAQ"
 ---
 
 Quick-start and first-run Q&A. For everyday operations, models, auth, sessions,
diff --git a/docs/help/faq-models.md b/docs/help/faq-models.md
index f261de8d875..64627235c5a 100644
--- a/docs/help/faq-models.md
+++ b/docs/help/faq-models.md
@@ -4,7 +4,8 @@ read_when:
   - Choosing or switching models, configuring aliases
   - Debugging model failover / "All models failed"
   - Understanding auth profiles and how to manage them
-title: "FAQ — models and auth profiles"
+title: "FAQ: models and auth"
+sidebarTitle: "Models FAQ"
 ---
 
 Model- and auth-profile Q&A. For setup, sessions, gateway, channels, and
diff --git a/docs/help/testing-live.md b/docs/help/testing-live.md
index e85ed36c2d1..c0a61b6013e 100644
--- a/docs/help/testing-live.md
+++ b/docs/help/testing-live.md
@@ -4,7 +4,8 @@ read_when:
   - Running live model matrix / CLI backend / ACP / media-provider smokes
   - Debugging live-test credential resolution
   - Adding a new provider-specific live test
-title: "Testing — live suites"
+title: "Testing: live suites"
+sidebarTitle: "Live tests"
 ---
 
 For quick start, QA runners, unit/integration suites, and Docker flows, see