From 438cb14222961107573451f15a6ea949304b1362 Mon Sep 17 00:00:00 2001
From: Artfizer <artifizer@gmail.com>
Date: Sat, 11 Jul 2026 02:10:10 +0300
Subject: [PATCH 1/2] fix(sidebar): align sections with gears-rust content
 restructure

Replace the stale nine-section skeleton (Getting Started, Guides,
Architecture, Reference, Examples, Contributing) with the six sections
that match the current docs/web-docs directories in gears-rust:
Introduction, Capabilities, Build with Gears, CLI, Concepts, Contribute.

The old config autogenerated from directories that no longer exist,
producing empty/broken sidebar groups and hiding the new sections.

Signed-off-by: Artfizer <artifizer@gmail.com>
---
 astro.config.mjs | 35 ++++++++++++-----------------------
 1 file changed, 12 insertions(+), 23 deletions(-)

diff --git a/astro.config.mjs b/astro.config.mjs
index 45eff6a..1b4afd4 100644
--- a/astro.config.mjs
+++ b/astro.config.mjs
@@ -73,17 +73,22 @@ export default defineConfig({
           href: 'https://github.com/constructorfabric/gears-rust',
         },
       ],
-      // Sidebar skeleton — the nine top-level sections from the IA.
-      // Each section is autogenerated from its directory for now (Phase 1).
-      // Explicit ordering/labels are tightened in Phase 3.
+      // Sidebar — the top-level sections from docs/web-docs/toc.md (in the
+      // gears-rust repo). Each section is autogenerated from its directory;
+      // per-page order comes from each page's `sidebar.order` frontmatter. The
+      // CLI section is synced from the cargo-gears repo, not authored here.
       sidebar: [
         {
           label: 'Introduction',
           items: [{ autogenerate: { directory: 'introduction' } }],
         },
         {
-          label: 'Getting Started',
-          items: [{ autogenerate: { directory: 'get-started' } }],
+          label: 'Capabilities',
+          items: [{ autogenerate: { directory: 'capabilities' } }],
+        },
+        {
+          label: 'Build with Gears',
+          items: [{ autogenerate: { directory: 'build-with-gears' } }],
         },
         {
           label: 'CLI',
@@ -94,24 +99,8 @@ export default defineConfig({
           items: [{ autogenerate: { directory: 'concepts' } }],
         },
         {
-          label: 'Guides',
-          items: [{ autogenerate: { directory: 'guides' } }],
-        },
-        {
-          label: 'Architecture',
-          items: [{ autogenerate: { directory: 'architecture' } }],
-        },
-        {
-          label: 'Reference',
-          items: [{ autogenerate: { directory: 'reference' } }],
-        },
-        {
-          label: 'Examples',
-          items: [{ autogenerate: { directory: 'examples' } }],
-        },
-        {
-          label: 'Contributing',
-          items: [{ autogenerate: { directory: 'contributing' } }],
+          label: 'Contribute',
+          items: [{ autogenerate: { directory: 'contribute' } }],
         },
       ],
     }),

From 9d9c0e63bfd99cf8804ea497be3a77222f58889c Mon Sep 17 00:00:00 2001
From: Artfizer <artifizer@gmail.com>
Date: Sat, 11 Jul 2026 02:11:38 +0300
Subject: [PATCH 2/2] fix(sidebar): rename CLI to 'cargo gears CLI' and move it
 after Concepts

Signed-off-by: Artfizer <artifizer@gmail.com>
---
 astro.config.mjs | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/astro.config.mjs b/astro.config.mjs
index 1b4afd4..06e7563 100644
--- a/astro.config.mjs
+++ b/astro.config.mjs
@@ -90,14 +90,14 @@ export default defineConfig({
           label: 'Build with Gears',
           items: [{ autogenerate: { directory: 'build-with-gears' } }],
         },
-        {
-          label: 'CLI',
-          items: [{ autogenerate: { directory: 'cli' } }],
-        },
         {
           label: 'Concepts',
           items: [{ autogenerate: { directory: 'concepts' } }],
         },
+        {
+          label: 'cargo gears CLI',
+          items: [{ autogenerate: { directory: 'cli' } }],
+        },
         {
           label: 'Contribute',
           items: [{ autogenerate: { directory: 'contribute' } }],