docs(nav): declutter the sidebar — text-only, three sections, one screen

os-zhuang · claude · os-zhuang · commit d5907db83457 · 2026-07-24T09:46:34.000+08:00
Feedback pass on the audience-first IA: the sidebar still read as crowded.
- Drop the hardcoded Docs/Blog links above the tree (layout.shared.tsx)
- Strip per-item icons from all 14 section meta.json files (text-only tree)
- Merge the one-item Operate section: Learn / Build / Platform
- Take References and Releases (lookup content, 22 generated/log pages) out
  of the tree — URLs still resolve (verified 200) and the docs home page
  links both; getting-started no longer defaultOpen so the first screen
  shows all twelve top-level entries at once

Co-Authored-By: Claude Fable 5 &lt;noreply@anthropic.com&gt;
diff --git a/apps/docs/lib/layout.shared.tsx b/apps/docs/lib/layout.shared.tsx
@@ -17,10 +17,6 @@ export function baseOptions(): BaseLayoutProps {
         </div>
       ),
     },
-    links: [
-      { text: 'Docs', url: '/docs', active: 'nested-url' },
-      { text: 'Blog', url: '/blog', active: 'nested-url' },
-    ],
     githubUrl: `https://github.com/${gitConfig.user}/${gitConfig.repo}`,
   };
 }
diff --git a/content/docs/ai/meta.json b/content/docs/ai/meta.json
@@ -1,6 +1,5 @@
 {
   "title": "AI",
-  "icon": "Bot",
   "pages": [
     "index",
     "connect-mcp",
diff --git a/content/docs/api/meta.json b/content/docs/api/meta.json
@@ -1,6 +1,5 @@
 {
   "title": "API & SDK",
-  "icon": "Plug",
   "pages": [
     "index",
     "data-api",
diff --git a/content/docs/automation/meta.json b/content/docs/automation/meta.json
@@ -1,6 +1,5 @@
 {
   "title": "Automation",
-  "icon": "Workflow",
   "pages": [
     "index",
     "hooks",
diff --git a/content/docs/concepts/meta.json b/content/docs/concepts/meta.json
@@ -1,6 +1,5 @@
 {
   "title": "Core Concepts",
-  "icon": "Lightbulb",
   "pages": [
     "index",
     "architecture",
diff --git a/content/docs/data-modeling/meta.json b/content/docs/data-modeling/meta.json
@@ -1,6 +1,5 @@
 {
   "title": "Data Modeling",
-  "icon": "Database",
   "pages": [
     "index",
     "schema-design",
diff --git a/content/docs/deployment/meta.json b/content/docs/deployment/meta.json
@@ -1,6 +1,5 @@
 {
   "title": "Deployment & Operations",
-  "icon": "Cloud",
   "pages": [
     "index",
     "cli",
diff --git a/content/docs/getting-started/meta.json b/content/docs/getting-started/meta.json
@@ -1,7 +1,5 @@
 {
   "title": "Get Started",
-  "icon": "Rocket",
-  "defaultOpen": true,
   "pages": [
     "---Start Here---",
     "index",
diff --git a/content/docs/kernel/meta.json b/content/docs/kernel/meta.json
@@ -1,6 +1,5 @@
 {
   "title": "Kernel & Services",
-  "icon": "Cpu",
   "pages": [
     "index",
     "architecture",
diff --git a/content/docs/meta.json b/content/docs/meta.json
@@ -11,13 +11,10 @@
     "permissions",
     "ai",
     "api",
-    "---Operate---",
+    "---Platform---",
     "deployment",
-    "---Extend & Reference---",
     "plugins",
     "kernel",
-    "protocol",
-    "references",
-    "releases"
+    "protocol"
   ]
 }
diff --git a/content/docs/permissions/meta.json b/content/docs/permissions/meta.json
@@ -1,6 +1,5 @@
 {
   "title": "Permissions & Identity",
-  "icon": "Shield",
   "pages": [
     "index",
     "administrator-guide",
diff --git a/content/docs/plugins/meta.json b/content/docs/plugins/meta.json
@@ -1,6 +1,5 @@
 {
   "title": "Plugins & Packages",
-  "icon": "Puzzle",
   "pages": [
     "index",
     "anatomy",
diff --git a/content/docs/protocol/meta.json b/content/docs/protocol/meta.json
@@ -1,6 +1,5 @@
 {
   "title": "Protocol Spec",
-  "icon": "Network",
   "pages": [
     "index",
     "diagram",
diff --git a/content/docs/references/meta.json b/content/docs/references/meta.json
@@ -1,6 +1,5 @@
 {
   "title": "Reference",
-  "icon": "FileCode",
   "pages": [
     "ai",
     "api",
@@ -17,4 +16,4 @@
     "system",
     "ui"
   ]
-}
+}
diff --git a/content/docs/releases/meta.json b/content/docs/releases/meta.json
@@ -1,5 +1,13 @@
 {
   "title": "Releases",
-  "icon": "Tag",
-  "pages": ["index", "v16", "v15", "v14", "v13", "v12", "v9", "implementation-status"]
+  "pages": [
+    "index",
+    "v16",
+    "v15",
+    "v14",
+    "v13",
+    "v12",
+    "v9",
+    "implementation-status"
+  ]
 }
diff --git a/content/docs/ui/meta.json b/content/docs/ui/meta.json
@@ -1,6 +1,5 @@
 {
   "title": "Views & Apps",
-  "icon": "LayoutDashboard",
   "pages": [
     "index",
     "apps",

Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,5 @@`
`1`	`1`	`{`
`2`	`2`	`"title": "AI",`
`3`		`- "icon": "Bot",`
`4`	`3`	`"pages": [`
`5`	`4`	`"index",`
`6`	`5`	`"connect-mcp",`
Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,5 @@`
`1`	`1`	`{`
`2`	`2`	`"title": "API & SDK",`
`3`		`- "icon": "Plug",`
`4`	`3`	`"pages": [`
`5`	`4`	`"index",`
`6`	`5`	`"data-api",`
Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,5 @@`
`1`	`1`	`{`
`2`	`2`	`"title": "Automation",`
`3`		`- "icon": "Workflow",`
`4`	`3`	`"pages": [`
`5`	`4`	`"index",`
`6`	`5`	`"hooks",`
Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,5 @@`
`1`	`1`	`{`
`2`	`2`	`"title": "Core Concepts",`
`3`		`- "icon": "Lightbulb",`
`4`	`3`	`"pages": [`
`5`	`4`	`"index",`
`6`	`5`	`"architecture",`
Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,5 @@`
`1`	`1`	`{`
`2`	`2`	`"title": "Data Modeling",`
`3`		`- "icon": "Database",`
`4`	`3`	`"pages": [`
`5`	`4`	`"index",`
`6`	`5`	`"schema-design",`
Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,5 @@`
`1`	`1`	`{`
`2`	`2`	`"title": "Deployment & Operations",`
`3`		`- "icon": "Cloud",`
`4`	`3`	`"pages": [`
`5`	`4`	`"index",`
`6`	`5`	`"cli",`
Original file line number	Diff line number	Diff line change
`@@ -1,7 +1,5 @@`
`1`	`1`	`{`
`2`	`2`	`"title": "Get Started",`
`3`		`- "icon": "Rocket",`
`4`		`- "defaultOpen": true,`
`5`	`3`	`"pages": [`
`6`	`4`	`"---Start Here---",`
`7`	`5`	`"index",`
Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,5 @@`
`1`	`1`	`{`
`2`	`2`	`"title": "Kernel & Services",`
`3`		`- "icon": "Cpu",`
`4`	`3`	`"pages": [`
`5`	`4`	`"index",`
`6`	`5`	`"architecture",`