docs: Split API and guide sidebars

Author: ntucker

docs/core/README.md

@@ -3,6 +3,7 @@ title: Introducing the Reactive Data Client
 sidebar_label: Introduction
 description: Building delightful dynamic applications with NextJS, Expo, React Native and more.
 slug: /
+id: introduction
 ---
 
 import ThemedImage from '@theme/ThemedImage';

website/docusaurus.config.ts

@@ -405,15 +405,16 @@ const config: Config = {
       hideOnScroll: true,
       items: [
         {
-          to: 'docs',
-          label: 'Docs',
+          type: 'doc',
           position: 'left',
+          docId: 'introduction',
+          label: 'Docs',
         },
         {
-          to: 'docs/api/useSuspense',
-          label: 'Hooks',
+          type: 'docSidebar',
           position: 'left',
-          activeBasePath: '/donotuse',
+          sidebarId: 'api',
+          label: 'API',
         },
         {
           to: 'rest',

website/sidebars.json

@@ -2,7 +2,7 @@
   "docs": [
     {
       "type": "doc",
-      "id": "README"
+      "id": "introduction"
     },
     {
       "type": "category",
@@ -70,7 +70,6 @@
       "type": "category",
       "label": "Tooling",
       "items": [
-
         {
           "type": "doc",
           "id": "guides/storybook"
@@ -136,163 +135,156 @@
           ]
         }
       ]
+    }
+  ],
+  "api": [
+    {
+      "type": "category",
+      "label": "Hooks",
+      "items": [
+        {
+          "type": "doc",
+          "id": "api/useSuspense"
+        },
+        {
+          "type": "doc",
+          "id": "api/useController"
+        },
+        {
+          "type": "doc",
+          "id": "api/useCache"
+        },
+        {
+          "type": "doc",
+          "id": "api/useQuery"
+        },
+        {
+          "type": "doc",
+          "id": "api/useLive"
+        },
+        {
+          "type": "doc",
+          "id": "api/useSubscription"
+        },
+        {
+          "type": "doc",
+          "id": "api/useFetch"
+        },
+        {
+          "type": "doc",
+          "id": "api/useDLE"
+        },
+        {
+          "type": "doc",
+          "id": "api/useError"
+        },
+        {
+          "type": "doc",
+          "id": "api/useLoading"
+        },
+        {
+          "type": "doc",
+          "id": "api/useDebounce"
+        },
+        {
+          "type": "doc",
+          "id": "api/useCancelling"
+        }
+      ]
+    },
+    {
+      "type": "doc",
+      "id": "api/Controller"
+    },
+    {
+      "type": "doc",
+      "id": "api/Snapshot"
     },
     {
       "type": "category",
-      "label": "API",
+      "label": "Components",
       "items": [
-
         {
           "type": "doc",
-          "id": "api/Controller"
+          "id": "api/DataProvider"
         },
         {
           "type": "doc",
-          "id": "api/Snapshot"
+          "id": "api/ExternalDataProvider"
         },
         {
-          "type": "category",
-          "label": "Hooks",
-          "items": [
-
-            {
-              "type": "doc",
-              "id": "api/useSuspense"
-            },
-            {
-              "type": "doc",
-              "id": "api/useController"
-            },
-            {
-              "type": "doc",
-              "id": "api/useCache"
-            },
-            {
-              "type": "doc",
-              "id": "api/useQuery"
-            },
-            {
-              "type": "doc",
-              "id": "api/useLive"
-            },
-            {
-              "type": "doc",
-              "id": "api/useSubscription"
-            },
-            {
-              "type": "doc",
-              "id": "api/useFetch"
-            },
-            {
-              "type": "doc",
-              "id": "api/useDLE"
-            },
-            {
-              "type": "doc",
-              "id": "api/useError"
-            },
-            {
-              "type": "doc",
-              "id": "api/useLoading"
-            },
-            {
-              "type": "doc",
-              "id": "api/useDebounce"
-            },
-            {
-              "type": "doc",
-              "id": "api/useCancelling"
-            }
-          ]
+          "type": "doc",
+          "id": "api/AsyncBoundary"
         },
         {
-          "type": "category",
-          "label": "Components",
-          "items": [
-            {
-              "type": "doc",
-              "id": "api/DataProvider"
-            },
-            {
-              "type": "doc",
-              "id": "api/ExternalDataProvider"
-            },
-            {
-              "type": "doc",
-              "id": "api/AsyncBoundary"
-            },
-            {
-              "type": "doc",
-              "id": "api/ErrorBoundary"
-            }
-          ]
+          "type": "doc",
+          "id": "api/ErrorBoundary"
+        }
+      ]
+    },
+    {
+      "type": "category",
+      "label": "Managers",
+      "items": [
+        {
+          "type": "doc",
+          "id": "api/Manager"
         },
         {
-          "type": "category",
-          "label": "Managers",
-          "items": [
-            {
-              "type": "doc",
-              "id": "api/Manager"
-            },
-            {
-              "type": "doc",
-              "id": "api/Actions"
-            },
-            {
-              "type": "doc",
-              "id": "api/getDefaultManagers"
-            },
-            {
-              "type": "doc",
-              "id": "api/NetworkManager"
-            },
-            {
-              "type": "doc",
-              "id": "api/SubscriptionManager"
-            },
-            {
-              "type": "doc",
-              "id": "api/PollingSubscription"
-            },
-            {
-              "type": "doc",
-              "id": "api/DevToolsManager"
-            },
-            {
-              "type": "doc",
-              "id": "api/LogoutManager"
-            }
-          ]
+          "type": "doc",
+          "id": "api/Actions"
         },
         {
-          "type": "category",
-          "label": "Testing",
-          "items": [
-            {
-              "type": "doc",
-              "id": "api/Fixtures"
-            },
-            {
-              "type": "doc",
-              "id": "api/MockResolver"
-            },
-            {
-              "type": "doc",
-              "id": "api/makeRenderDataClient"
-            },
-            {
-              "type": "doc",
-              "id": "api/mockInitialState"
-            }
-          ]
+          "type": "doc",
+          "id": "api/getDefaultManagers"
+        },
+        {
+          "type": "doc",
+          "id": "api/NetworkManager"
+        },
+        {
+          "type": "doc",
+          "id": "api/SubscriptionManager"
+        },
+        {
+          "type": "doc",
+          "id": "api/PollingSubscription"
         },
         {
           "type": "doc",
-          "id": "api/types"
+          "id": "api/DevToolsManager"
+        },
+        {
+          "type": "doc",
+          "id": "api/LogoutManager"
         }
       ]
+    },
+    {
+      "type": "category",
+      "label": "Testing",
+      "items": [
+        {
+          "type": "doc",
+          "id": "api/Fixtures"
+        },
+        {
+          "type": "doc",
+          "id": "api/MockResolver"
+        },
+        {
+          "type": "doc",
+          "id": "api/makeRenderDataClient"
+        },
+        {
+          "type": "doc",
+          "id": "api/mockInitialState"
+        }
+      ]
+    },
+    {
+      "type": "doc",
+      "id": "api/types"
     }
-
   ]
 }