docs: Update sidebar (#7723)

I have had some feedback that the sidebar is too long and disorganized.
The sidebar has not been updated much in the transition to the new docs site.

I am expecting some feedback here, but this is a first pass.

The docs archive has been removed as this is now linked from the top of
the docs nav.

Signed-off-by: Charlie Egan <[email protected]>

Author: Charlie Egan

docs/docs/cli.md

@@ -1,5 +1,5 @@
 ---
-title: CLI
+title: CLI Reference
 ---
 
 The commands exposed in the `opa` executable are listed here in alphabetical

docs/docs/debugging/index.md

@@ -1,12 +1,12 @@
 ---
-title: Debugging OPA
+title: Debugging
 ---
 
+# Debugging Rego Policies
+
 This section outlines the various tools and techniques that can be used to debug OPA, both as a component in a
 distributed system and as a policy engine evaluating the Rego language.
 
-# Debugging Rego Policies
-
 Debugging Rego is crucial to ensuring OPA functions properly, as its policy
 engine evaluates policies written in Rego. Effective Rego debugging helps
 identify and resolve issues that impact OPA’s performance and behavior. A strong

docs/docs/rest-api.md

@@ -1,5 +1,5 @@
 ---
-title: REST API
+title: REST API Reference
 sidebar_position: 10
 ---
 

docs/src/lib/sidebars.js

@@ -7,41 +7,57 @@ module.exports = {
     "policy-testing",
     "policy-performance",
     { type: "autogenerated", dirName: "external-data" },
-    "integration",
-    "extensions",
-    { type: "autogenerated", dirName: "debugging" },
-    "rest-api",
-    "cli",
-    "editor-and-ide-support",
-    "ir",
-    "wasm",
-    "v0-compatibility",
-    { type: "autogenerated", dirName: "v0-upgrade" },
-    { type: "html", value: "<hr>" },
     {
       type: "category",
-      label: "Envoy",
+      label: "Management APIs",
       collapsible: true,
       collapsed: true,
       items: [
-        { type: "autogenerated", dirName: "envoy" },
+        { type: "autogenerated", dirName: "management-introduction" },
+        { type: "autogenerated", dirName: "management-bundles" },
+        "management-decision-logs",
+        "management-status",
+        "management-discovery",
       ],
     },
     {
       type: "category",
-      label: "Kubernetes",
+      label: "Operations & Configuration",
       collapsible: true,
       collapsed: true,
       items: [
-        { type: "autogenerated", dirName: "kubernetes" },
+        "configuration",
+        "deployments",
+        "monitoring",
+        "security",
+        "privacy",
+        "storage",
       ],
     },
     {
       type: "category",
-      label: "Other Use Cases",
+      label: "Use Cases",
       collapsible: true,
       collapsed: true,
       items: [
+        {
+          type: "category",
+          label: "Envoy & Istio",
+          collapsible: true,
+          collapsed: true,
+          items: [
+            { type: "autogenerated", dirName: "envoy" },
+          ],
+        },
+        {
+          type: "category",
+          label: "Kubernetes",
+          collapsible: true,
+          collapsed: true,
+          items: [
+            { type: "autogenerated", dirName: "kubernetes" },
+          ],
+        },
         "cicd",
         "aws-cloudformation-hooks",
         "docker-authorization",
@@ -53,32 +69,26 @@ module.exports = {
         "oauth-oidc",
       ],
     },
-    { type: "html", value: "<hr>" },
     {
       type: "category",
-      label: "Operations",
+      label: "Developer Resources",
       collapsible: true,
       collapsed: true,
       items: [
-        "configuration",
-        "deployments",
-        "monitoring",
-        "security",
-        "privacy",
-        "storage",
+        { type: "autogenerated", dirName: "debugging" },
+        "cli",
+        "editor-and-ide-support",
       ],
     },
     {
       type: "category",
-      label: "Management APIs",
+      label: "Build on OPA",
       collapsible: true,
       collapsed: true,
       items: [
-        { type: "autogenerated", dirName: "management-introduction" },
-        { type: "autogenerated", dirName: "management-bundles" },
-        "management-decision-logs",
-        "management-status",
-        "management-discovery",
+        "integration",
+        "extensions",
+        "rest-api",
       ],
     },
     {
@@ -95,22 +105,34 @@ module.exports = {
       ],
     },
     {
-      type: "link",
-      label: "Documentation Archive",
-      href: "/docs/archive",
+      type: "category",
+      label: "OPA v0",
+      collapsible: true,
+      collapsed: true,
+      items: [
+        "v0-compatibility",
+        { type: "autogenerated", dirName: "v0-upgrade" },
+      ],
+    },
+    {
+      type: "category",
+      label: "Alternative Runtimes",
+      collapsible: true,
+      collapsed: true,
+      items: [
+        "ir",
+        "wasm",
+      ],
     },
     "faq",
     "comparison-to-other-systems",
+    { type: "html", value: "<hr>" },
     {
       type: "link",
       label: "Enterprise Support",
       href: "/support",
     },
-    {
-      type: "link",
-      label: "OPA Ecosystem",
-      href: "/ecosystem",
-    },
+    { type: "html", value: "<hr>" },
   ],
   rootSidebar: [],
 };