feat(nav): update navigation structure for products

Restructure nav data for all products to use section-based grouping
with Getting started sections. Update generateMarkdownFooter test to
match the new section structure.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: m-hulbert

data/onPostBuild/generateMarkdownFooter.test.ts

@@ -77,10 +77,10 @@ describe('generateMarkdownFooter', () => {
       expect(setupPage?.sectionKey).toBe('Ably Chat::Concepts');
     });
 
-    it('should use __root__ section key for top-level pages', () => {
+    it('should use section key for pages nested in a section', () => {
       const pages = flattenNavPages();
       const aboutChat = pages.find((p) => p.link === '/docs/chat');
-      expect(aboutChat?.sectionKey).toBe('Ably Chat::__root__');
+      expect(aboutChat?.sectionKey).toBe('Ably Chat::Getting started');
     });
 
     it('should handle nested sections correctly', () => {

src/data/nav/aitransport.ts

@@ -9,12 +9,30 @@ export default {
   },
   content: [
     {
-      name: 'Overview',
-      link: '/docs/ai-transport',
-      index: true,
+      name: 'Getting started',
+      pages: [
+        {
+          name: 'About AI Transport',
+          link: '/docs/ai-transport',
+          index: true,
+        },
+        {
+          name: 'By SDK',
+          pages: [
+            {
+              name: 'Core SDK',
+              link: '/docs/ai-transport/getting-started/core-sdk',
+            },
+            {
+              name: 'Vercel AI SDK',
+              link: '/docs/ai-transport/getting-started/vercel-ai-sdk',
+            },
+          ],
+        },
+      ],
     },
     {
-      name: 'Why AI Transport',
+      name: 'Why AI Transport?',
       pages: [
         {
           name: 'Overview',
@@ -61,19 +79,6 @@ export default {
         },
       ],
     },
-    {
-      name: 'Getting started',
-      pages: [
-        {
-          name: 'Core SDK',
-          link: '/docs/ai-transport/getting-started/core-sdk',
-        },
-        {
-          name: 'Vercel AI SDK',
-          link: '/docs/ai-transport/getting-started/vercel-ai-sdk',
-        },
-      ],
-    },
     {
       name: 'Frameworks',
       pages: [
@@ -153,12 +158,17 @@ export default {
       ],
     },
     {
-      name: 'Going to production',
-      link: '/docs/ai-transport/going-to-production',
-    },
-    {
-      name: 'Troubleshooting',
-      link: '/docs/ai-transport/troubleshooting',
+      name: 'Production',
+      pages: [
+        {
+          name: 'Going to production',
+          link: '/docs/ai-transport/going-to-production',
+        },
+        {
+          name: 'Troubleshooting',
+          link: '/docs/ai-transport/troubleshooting',
+        },
+      ],
     },
     {
       name: 'API reference',

src/data/nav/chat.ts

@@ -8,50 +8,55 @@ export default {
     open: 'icon-gui-prod-chat-solid',
   },
   content: [
-    {
-      name: 'About Chat',
-      link: '/docs/chat',
-      index: true,
-    },
     {
       name: 'Getting started',
       pages: [
         {
-          name: 'Overview',
-          link: '/docs/chat/getting-started',
+          name: 'About Chat',
+          link: '/docs/chat',
           index: true,
         },
         {
-          name: 'JavaScript',
-          link: '/docs/chat/getting-started/javascript',
-        },
-        {
-          name: 'React',
-          link: '/docs/chat/getting-started/react',
-        },
-        {
-          name: 'React Native',
-          link: '/docs/chat/getting-started/react-native',
-        },
-        {
-          name: 'Kotlin (Android)',
-          link: '/docs/chat/getting-started/android',
-        },
-        {
-          name: 'Kotlin (JVM)',
-          link: '/docs/chat/getting-started/jvm',
-        },
-        {
-          name: 'Swift',
-          link: '/docs/chat/getting-started/swift',
-        },
-        {
-          name: 'Swift (AsyncSequence)',
-          link: '/docs/chat/getting-started/swift-async-sequence',
-        },
-        {
-          name: 'React UI Kit',
-          link: '/docs/chat/getting-started/react-ui-kit',
+          name: 'By language',
+          pages: [
+            {
+              name: 'Overview',
+              link: '/docs/chat/getting-started',
+              index: true,
+            },
+            {
+              name: 'JavaScript',
+              link: '/docs/chat/getting-started/javascript',
+            },
+            {
+              name: 'React',
+              link: '/docs/chat/getting-started/react',
+            },
+            {
+              name: 'React Native',
+              link: '/docs/chat/getting-started/react-native',
+            },
+            {
+              name: 'Kotlin (Android)',
+              link: '/docs/chat/getting-started/android',
+            },
+            {
+              name: 'Kotlin (JVM)',
+              link: '/docs/chat/getting-started/jvm',
+            },
+            {
+              name: 'Swift',
+              link: '/docs/chat/getting-started/swift',
+            },
+            {
+              name: 'Swift (AsyncSequence)',
+              link: '/docs/chat/getting-started/swift-async-sequence',
+            },
+            {
+              name: 'React UI Kit',
+              link: '/docs/chat/getting-started/react-ui-kit',
+            },
+          ],
         },
       ],
     },

src/data/nav/liveobjects.ts

@@ -8,26 +8,31 @@ export default {
     open: 'icon-gui-prod-liveobjects-solid',
   },
   content: [
-    {
-      name: 'About LiveObjects',
-      link: '/docs/liveobjects',
-      index: true,
-      languages: ['javascript', 'swift', 'java'],
-    },
     {
       name: 'Getting started',
       pages: [
         {
-          name: 'JavaScript',
-          link: '/docs/liveobjects/quickstart/javascript',
-        },
-        {
-          name: 'Swift',
-          link: '/docs/liveobjects/quickstart/swift',
+          name: 'About LiveObjects',
+          link: '/docs/liveobjects',
+          index: true,
+          languages: ['javascript', 'swift', 'java'],
         },
         {
-          name: 'Java',
-          link: '/docs/liveobjects/quickstart/java',
+          name: 'By language',
+          pages: [
+            {
+              name: 'JavaScript',
+              link: '/docs/liveobjects/quickstart/javascript',
+            },
+            {
+              name: 'Swift',
+              link: '/docs/liveobjects/quickstart/swift',
+            },
+            {
+              name: 'Java',
+              link: '/docs/liveobjects/quickstart/java',
+            },
+          ],
         },
       ],
     },

src/data/nav/livesync.ts

@@ -9,9 +9,14 @@ export default {
   },
   content: [
     {
-      name: 'About LiveSync',
-      link: '/docs/livesync',
-      index: true,
+      name: 'Getting started',
+      pages: [
+        {
+          name: 'About LiveSync',
+          link: '/docs/livesync',
+          index: true,
+        },
+      ],
     },
     {
       name: 'MongoDB',

src/data/nav/platform.ts

@@ -9,9 +9,14 @@ export default {
   },
   content: [
     {
-      name: 'About Ably',
-      link: '/docs/platform',
-      index: true,
+      name: 'Getting started',
+      pages: [
+        {
+          name: 'About Ably',
+          link: '/docs/platform',
+          index: true,
+        },
+      ],
     },
     {
       name: 'Architecture',