Update docs navigation and meta config structure

hotlong · hotlong · commit be03cf3b99b0 · 2026-01-19T19:03:11.000+08:00
Simplifies navigation links in layout.config.tsx to a single 'Documentation' entry and comments out others. Adds or removes 'root' property in various meta.json files to standardize documentation structure and improve organization.
diff --git a/apps/docs/app/layout.config.tsx b/apps/docs/app/layout.config.tsx
@@ -18,25 +18,25 @@ export const baseOptions: BaseLayoutProps = {
   },
   links: [
     {
-      text: 'Guides',
-      url: '/docs/guides/getting-started',
-      active: 'nested-url',
-    },
-    {
-      text: 'Concepts',
-      url: '/docs/concepts/manifesto',
-      active: 'nested-url',
-    },
-    {
-      text: 'Specs',
-      url: '/docs/specifications/data/architecture',
-      active: 'nested-url',
-    },
-    {
-      text: 'Reference',
-      url: '/docs/references/data/core/Object',
+      text: 'Documentation',
+      url: '/docs/',
       active: 'nested-url',
     },
+    // {
+    //   text: 'Concepts',
+    //   url: '/docs/concepts/manifesto',
+    //   active: 'nested-url',
+    // },
+    // {
+    //   text: 'Specs',
+    //   url: '/docs/specifications/data/architecture',
+    //   active: 'nested-url',
+    // },
+    // {
+    //   text: 'Reference',
+    //   url: '/docs/references/data/core/Object',
+    //   active: 'nested-url',
+    // },
   ],
   githubUrl: 'https://github.com/objectstack-ai/spec',
 };
diff --git a/content/docs/concepts/meta.json b/content/docs/concepts/meta.json
@@ -1,5 +1,6 @@
 {
   "title": "Concepts",
+  "root": true,
   "pages": [
     "manifesto",
     "core-values",
diff --git a/content/docs/guides/meta.json b/content/docs/guides/meta.json
@@ -1,5 +1,6 @@
 {
   "title": "Developer Guides",
+  "root": true,
   "pages": [
     "getting-started",
     "installation",
diff --git a/content/docs/meta.json b/content/docs/meta.json
@@ -1,7 +1,6 @@
 {
   "title": "Documentation",
   "pages": [
-    "index",
     "guides",
     "concepts",
     "specifications",
diff --git a/content/docs/references/ai/meta.json b/content/docs/references/ai/meta.json
@@ -1,4 +1,3 @@
 {
-  "title": "AI Protocol",
-  "root": true
+  "title": "AI Protocol"
 }
diff --git a/content/docs/references/data/meta.json b/content/docs/references/data/meta.json
@@ -1,6 +1,5 @@
 {
   "title": "Data Protocol",
-  "root": true,
   "pages": [
     "core",
     "logic",
diff --git a/content/docs/references/meta.json b/content/docs/references/meta.json
@@ -1,5 +1,6 @@
 {
   "label": "Protocol Reference",
+  "root": true,
   "order": 100,
   "pages": [
     "data",
diff --git a/content/docs/references/system/meta.json b/content/docs/references/system/meta.json
@@ -1,6 +1,5 @@
 {
   "title": "System Protocol",
-  "root": true,
   "pages": [
     "identity",
     "integration",
diff --git a/content/docs/references/ui/meta.json b/content/docs/references/ui/meta.json
@@ -1,6 +1,5 @@
 {
   "title": "UI Protocol",
-  "root": true,
   "pages": [
     "app",
     "views",
diff --git a/content/docs/specifications/meta.json b/content/docs/specifications/meta.json
@@ -1,5 +1,6 @@
 {
   "title": "Specifications",
+  "root": true,
   "pages": [
     "data",
     "ui",

Original file line number	Diff line number	Diff line change
`@@ -1,5 +1,6 @@`
`1`	`1`	`{`
`2`	`2`	`"title": "Concepts",`
	`3`	`+ "root": true,`
`3`	`4`	`"pages": [`
`4`	`5`	`"manifesto",`
`5`	`6`	`"core-values",`
Original file line number	Diff line number	Diff line change
`@@ -1,5 +1,6 @@`
`1`	`1`	`{`
`2`	`2`	`"title": "Developer Guides",`
	`3`	`+ "root": true,`
`3`	`4`	`"pages": [`
`4`	`5`	`"getting-started",`
`5`	`6`	`"installation",`
Original file line number	Diff line number	Diff line change
`@@ -1,7 +1,6 @@`
`1`	`1`	`{`
`2`	`2`	`"title": "Documentation",`
`3`	`3`	`"pages": [`
`4`		`- "index",`
`5`	`4`	`"guides",`
`6`	`5`	`"concepts",`
`7`	`6`	`"specifications",`
Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,3 @@`
`1`	`1`	`{`
`2`		`- "title": "AI Protocol",`
`3`		`- "root": true`
	`2`	`+ "title": "AI Protocol"`
`4`	`3`	`}`
Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,5 @@`
`1`	`1`	`{`
`2`	`2`	`"title": "Data Protocol",`
`3`		`- "root": true,`
`4`	`3`	`"pages": [`
`5`	`4`	`"core",`
`6`	`5`	`"logic",`
Original file line number	Diff line number	Diff line change
`@@ -1,5 +1,6 @@`
`1`	`1`	`{`
`2`	`2`	`"label": "Protocol Reference",`
	`3`	`+ "root": true,`
`3`	`4`	`"order": 100,`
`4`	`5`	`"pages": [`
`5`	`6`	`"data",`
Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,5 @@`
`1`	`1`	`{`
`2`	`2`	`"title": "System Protocol",`
`3`		`- "root": true,`
`4`	`3`	`"pages": [`
`5`	`4`	`"identity",`
`6`	`5`	`"integration",`
Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,5 @@`
`1`	`1`	`{`
`2`	`2`	`"title": "UI Protocol",`
`3`		`- "root": true,`
`4`	`3`	`"pages": [`
`5`	`4`	`"app",`
`6`	`5`	`"views",`
Original file line number	Diff line number	Diff line change
`@@ -1,5 +1,6 @@`
`1`	`1`	`{`
`2`	`2`	`"title": "Specifications",`
	`3`	`+ "root": true,`
`3`	`4`	`"pages": [`
`4`	`5`	`"data",`
`5`	`6`	`"ui",`