docs: adjust sidebar & create new admin section

docs-website/sidebars.js

@@ -9,17 +9,13 @@ module.exports = {
 
   overviewSidebar: [
     {
-      label: "Getting Started",
+      label: "What Is DataHub?",
       type: "category",
       collapsed: true,
+      link: { type: "doc", id: "docs/features" },
       items: [
         // By the end of this section, readers should understand the core use cases that DataHub addresses,
         // target end-users, high-level architecture, & hosting options
-        {
-          type: "doc",
-          label: "Introduction",
-          id: "docs/features",
-        },
         {
           type: "doc",
           label: "Quickstart",
@@ -31,7 +27,6 @@ module.exports = {
           href: "https://demo.datahubproject.io/",
         },
         "docs/what-is-datahub/datahub-concepts",
-        "docs/saas",
       ],
     },
     {
@@ -161,7 +156,15 @@ module.exports = {
         "docs/deploy/azure",
         "docker/README",
         "docs/deploy/kubernetes",
+        "docs/deploy/confluent-cloud",
         "docs/deploy/environment-vars",
+        "docs/how/extract-container-logs",
+      ],
+    },
+    {
+      type: "category",
+      label: "Admin",
+      items: [
         {
           Authentication: [
             "docs/authentication/README",
@@ -195,20 +198,91 @@ module.exports = {
             "docs/how/restore-indices",
             "docs/advanced/db-retention",
             "docs/advanced/monitoring",
-            "docs/how/extract-container-logs",
             "docs/deploy/telemetry",
             "docs/how/kafka-config",
-            "docs/deploy/confluent-cloud",
             "docs/advanced/no-code-upgrade",
             "docs/how/jattach-guide",
           ],
         },
-        "docs/how/updating-datahub",
       ],
     },
     {
-      API: [
-        "docs/api/datahub-apis",
+      Developers: [
+        // The purpose of this section is to provide developers & technical users with
+        // concrete tutorials for how to work with the DataHub CLI & APIs
+        {
+          Architecture: [
+            "docs/architecture/architecture",
+            "docs/components",
+            "docs/architecture/metadata-ingestion",
+            "docs/architecture/metadata-serving",
+            "docs/architecture/docker-containers",
+          ],
+        },
+        {
+          "Metadata Model": [
+            "docs/modeling/metadata-model",
+            "docs/modeling/extending-the-metadata-model",
+            "docs/what/mxe",
+            {
+              Entities: [
+                {
+                  type: "autogenerated",
+                  dirName: "docs/generated/metamodel/entities", // '.' means the current docs folder
+                },
+              ],
+            },
+          ],
+        },
+        {
+          "Developing on DataHub": [
+            "docs/developers",
+            "docs/docker/development",
+            "metadata-ingestion/developing",
+            "docs/api/graphql/graphql-endpoint-development",
+            {
+              Modules: [
+                "datahub-web-react/README",
+                "datahub-frontend/README",
+                "datahub-graphql-core/README",
+                "metadata-service/README",
+                "metadata-jobs/mae-consumer-job/README",
+                "metadata-jobs/mce-consumer-job/README",
+              ],
+            },
+          ],
+        },
+        "docs/plugins",
+        {
+          Troubleshooting: [
+            "docs/troubleshooting/quickstart",
+            "docs/troubleshooting/build",
+            "docs/troubleshooting/general",
+          ],
+        },
+        {
+          Advanced: [
+            "metadata-ingestion/docs/dev_guides/reporting_telemetry",
+            "docs/advanced/mcp-mcl",
+            "docker/datahub-upgrade/README",
+            "docs/advanced/no-code-modeling",
+            "datahub-web-react/src/app/analytics/README",
+            "docs/how/migrating-graph-service-implementation",
+            "docs/advanced/field-path-spec-v2",
+            "metadata-ingestion/adding-source",
+            "docs/how/add-custom-ingestion-source",
+            "docs/how/add-custom-data-platform",
+            "docs/advanced/browse-paths-upgrade",
+            "docs/browseV2/browse-paths-v2",
+          ],
+        },
+      ],
+    },
+    {
+      type: "category",
+      label: "API",
+      link: { type: "doc", id: "docs/api/datahub-apis" },
+      items: [
         {
           "GraphQL API": [
             {
@@ -466,91 +540,14 @@ module.exports = {
       ],
     },
     {
-      Develop: [
-        // The purpose of this section is to provide developers & technical users with
-        // concrete tutorials for how to work with the DataHub CLI & APIs
-        {
-          "DataHub Metadata Model": [
-            "docs/modeling/metadata-model",
-            "docs/modeling/extending-the-metadata-model",
-            "docs/what/mxe",
-            {
-              Entities: [
-                {
-                  type: "autogenerated",
-                  dirName: "docs/generated/metamodel/entities", // '.' means the current docs folder
-                },
-              ],
-            },
-          ],
-        },
-        {
-          Architecture: [
-            "docs/architecture/architecture",
-            "docs/components",
-            "docs/architecture/metadata-ingestion",
-            "docs/architecture/metadata-serving",
-            "docs/architecture/docker-containers",
-          ],
-        },
-        {
-          "Developing on DataHub": [
-            "docs/developers",
-            "docs/docker/development",
-            "metadata-ingestion/developing",
-            "docs/api/graphql/graphql-endpoint-development",
-            {
-              Modules: [
-                "datahub-web-react/README",
-                "datahub-frontend/README",
-                "datahub-graphql-core/README",
-                "metadata-service/README",
-                "metadata-jobs/mae-consumer-job/README",
-                "metadata-jobs/mce-consumer-job/README",
-              ],
-            },
-          ],
-        },
-        "docs/plugins",
-        {
-          Troubleshooting: [
-            "docs/troubleshooting/quickstart",
-            "docs/troubleshooting/build",
-            "docs/troubleshooting/general",
-          ],
-        },
-        {
-          Advanced: [
-            "metadata-ingestion/docs/dev_guides/reporting_telemetry",
-            "docs/advanced/mcp-mcl",
-            "docker/datahub-upgrade/README",
-            "docs/advanced/no-code-modeling",
-            "datahub-web-react/src/app/analytics/README",
-            "docs/how/migrating-graph-service-implementation",
-            "docs/advanced/field-path-spec-v2",
-            "metadata-ingestion/adding-source",
-            "docs/how/add-custom-ingestion-source",
-            "docs/how/add-custom-data-platform",
-            "docs/advanced/browse-paths-upgrade",
-            "docs/browseV2/browse-paths-v2",
-          ],
-        },
-      ],
-    },
-    {
-      Community: [
-        "docs/slack",
-        "docs/townhalls",
-        "docs/townhall-history",
-        "docs/CODE_OF_CONDUCT",
-        "docs/CONTRIBUTING",
-        "docs/links",
-        "docs/rfc",
-      ],
-    },
-    {
-      "Managed DataHub": [
-        "docs/managed-datahub/managed-datahub-overview",
+      label: "Managed DataHub",
+      type: "category",
+      collapsed: true,
+      link: {
+        type: "doc",
+        id: "docs/managed-datahub/managed-datahub-overview",
+      },
+      items: [
         "docs/managed-datahub/welcome-acryl",
         {
           type: "doc",
@@ -647,7 +644,26 @@ module.exports = {
       ],
     },
     {
-      "Release History": ["releases"],
+      label: "Community",
+      type: "category",
+      collapsed: true,
+      link: {
+        type: "generated-index",
+        title: "Community",
+        description: "Learn about DataHub community.",
+      },
+      items: [
+        "docs/slack",
+        "docs/townhalls",
+        //        "docs/townhall-history",
+        "docs/CODE_OF_CONDUCT",
+        "docs/CONTRIBUTING",
+        "docs/links",
+        "docs/rfc",
+      ],
+    },
+    {
+      "Release History": ["releases", "docs/how/updating-datahub"],
     },
 
     // "Candidates for Deprecation": [

docs/CODE_OF_CONDUCT.md

@@ -1,4 +1,4 @@
-# Contributor Covenant Code of Conduct
+# Code of Conduct
 
 ## Our Pledge