alphabetize submenus on docs sidebar

website/docs/docs/build/enhance-your-code.md

@@ -7,21 +7,17 @@ pagination_prev: null
 
 <div className="grid--2-col">
 
-<Card
-    title="Project variables"
-    body="Learn how to use project variables to provide data to models for compilation."
-    link="/docs/build/project-variables"
-    icon="dbt-bit"/>
-
 <Card
     title="Environment variables"
     body="Learn how you can use environment variables to customize the behavior of a dbt project."
     link="/docs/build/environment-variables"
     icon="dbt-bit"/>
 
-</div>
-<br />
-<div className="grid--2-col">
+<Card
+    title="Hooks and operations"
+    body="Learn how to use hooks to trigger actions and operations to invoke macros."
+    link="/docs/build/hooks-operations"
+    icon="dbt-bit"/>
 
 <Card
     title="Packages"
@@ -30,9 +26,9 @@ pagination_prev: null
     icon="dbt-bit"/>
 
 <Card
-    title="Hooks and operations"
-    body="Learn how to use hooks to trigger actions and operations to invoke macros."
-    link="/docs/build/hooks-operations"
-    icon="dbt-bit"/>
+    title="Project variables"
+    body="Learn how to use project variables to provide data to models for compilation."
+    link="/docs/build/project-variables"
+    icon="dbt-bit"/>    
 
-</div>
+</div>

website/docs/docs/build/incremental-strategy.md

@@ -1,5 +1,6 @@
 ---
 title: "About incremental strategy"
+sidebar_label: "About incremental strategy"
 description: "Learn about the various ways (strategies) to implement incremental materializations."
 id: "incremental-strategy"
 ---

website/docs/docs/cloud/about-cloud-develop-defer.md

@@ -2,7 +2,7 @@
 title: Using defer in dbt Cloud
 id: about-cloud-develop-defer
 description: "Learn how to leverage defer to prod when developing with dbt Cloud."
-sidebar_label: "Using defer in dbt Cloud"
+sidebar_label: "Defer in dbt Cloud"
 pagination_next: "docs/cloud/cloud-cli-installation"
 ---
 

website/docs/docs/connect-adapters.md

@@ -1,5 +1,5 @@
 ---
-title: "How to connect to adapters"
+title: "Connect to adapters"
 id: "connect-adapters"
 ---
 

website/docs/docs/dbt-cloud-apis/sl-api-overview.md

@@ -30,18 +30,18 @@ plan="dbt Cloud Team or Enterprise"
 
 <div className="grid--3-col">
 
-<Card
-    title="JDBC API"
-    body="Use a JDBC driver to query metrics and dimensions in downstream tools, while also providing standard metadata functionality."
-    link="/docs/dbt-cloud-apis/sl-jdbc"
-    icon="dbt-bit"/>
-
 <Card
     title="GraphQL API"
     body="Use GraphQL to query metrics and dimensions in downstream tools."
     link="/docs/dbt-cloud-apis/sl-graphql"
     icon="dbt-bit"/>
 
+<Card
+    title="JDBC API"
+    body="Use a JDBC driver to query metrics and dimensions in downstream tools, while also providing standard metadata functionality."
+    link="/docs/dbt-cloud-apis/sl-jdbc"
+    icon="dbt-bit"/>
+
 <Card
     title="Python SDK"
     body="Use the Python SDK to interact with the dbt Semantic Layer using Python."

website/docs/docs/dbt-cloud-apis/user-tokens.md

@@ -1,5 +1,6 @@
 ---
 title: "User tokens"
+sidebar_label: "Personal access tokens "
 id: "user-tokens"
 pagination_next: "docs/dbt-cloud-apis/service-tokens"
 ---

website/docs/docs/deploy/monitor-jobs.md

@@ -10,13 +10,14 @@ Monitor your dbt Cloud jobs to help identify improvement and set up alerts to pr
 
 This portion of our documentation will go over dbt Cloud's various capabilities that help you monitor your jobs and set up alerts to ensure seamless orchestration, including:
 
-- [Run visibility](/docs/deploy/run-visibility) — View your run history to help identify where improvements can be made to scheduled jobs.
-- [Retry jobs](/docs/deploy/retry-jobs) — Rerun your errored jobs from start or the failure point.
-- [Job notifications](/docs/deploy/job-notifications) — Receive email or Slack notifications when a job run succeeds, encounters warnings, fails, or is canceled. 
-- [Model notifications](/docs/deploy/model-notifications) — Receive email notifications about any issues encountered by your models and tests as soon as they occur while running a job. 
-- [Webhooks](/docs/deploy/webhooks) — Use webhooks to send events about your dbt jobs' statuses to other systems.
-- [Leverage artifacts](/docs/deploy/artifacts) — dbt Cloud generates and saves artifacts for your project, which it uses to power features like creating docs for your project and reporting freshness of your sources.
-- [Source freshness](/docs/deploy/source-freshness) — Monitor data governance by enabling snapshots to capture the freshness of your data sources. 
+- [Leverage artifacts](/docs/deploy/artifacts) — dbt Cloud generates and saves artifacts for your project, which it uses to power features like creating docs for your project and reporting freshness of your sources.  
+- [Job notifications](/docs/deploy/job-notifications) — Receive email or Slack notifications when a job run succeeds, encounters warnings, fails, or is canceled.  
+- [Model notifications](/docs/deploy/model-notifications) — Receive email notifications about any issues encountered by your models and tests as soon as they occur while running a job.  
+- [Retry jobs](/docs/deploy/retry-jobs) — Rerun your errored jobs from start or the failure point.  
+- [Run visibility](/docs/deploy/run-visibility) — View your run history to help identify where improvements can be made to scheduled jobs.  
+- [Source freshness](/docs/deploy/source-freshness) — Monitor data governance by enabling snapshots to capture the freshness of your data sources.  
+- [Webhooks](/docs/deploy/webhooks) — Use webhooks to send events about your dbt jobs' statuses to other systems.  
+
 
 To set up and add data health tiles to view data freshness and quality checks in your dashboard, refer to [data health tiles](/docs/collaborate/data-tile).
 

website/docs/docs/supported-data-platforms.md

@@ -1,7 +1,7 @@
 ---
 title: "Supported data platforms"
 id: "supported-data-platforms"
-sidebar_label: "Supported data platforms"
+sidebar_label: "About supported data platforms"
 description: "Connect dbt to any data platform in dbt Cloud or dbt Core, using a dedicated adapter plugin"
 hide_table_of_contents: true
 pagination_next: "docs/connect-adapters"

website/sidebars.js

@@ -289,9 +289,9 @@ const sidebarSettings = {
           items: [
             "docs/cloud/dbt-cloud-ide/develop-in-the-cloud",
             "docs/cloud/dbt-cloud-ide/keyboard-shortcuts",
-            "docs/cloud/dbt-cloud-ide/ide-user-interface",
-            "docs/cloud/dbt-cloud-ide/lint-format",
             "docs/cloud/dbt-cloud-ide/git-commit-signing",
+            "docs/cloud/dbt-cloud-ide/lint-format",
+            "docs/cloud/dbt-cloud-ide/ide-user-interface",
             {
               type: "category",
               label: "dbt Copilot",
@@ -366,9 +366,9 @@ const sidebarSettings = {
               items: [
                 "docs/build/about-metricflow",
                 "docs/build/join-logic",
-                "docs/build/validation",
                 "docs/build/metricflow-time-spine",
                 "docs/build/metricflow-commands",
+                "docs/build/validation",
               ],
             },
             {
@@ -438,10 +438,10 @@ const sidebarSettings = {
           link: { type: "doc", id: "docs/build/enhance-your-code" },
           items: [
             "docs/build/enhance-your-code",
-            "docs/build/project-variables",
             "docs/build/environment-variables",
-            "docs/build/packages",
             "docs/build/hooks-operations",
+            "docs/build/packages",
+            "docs/build/project-variables",
           ],
         },
         {
@@ -500,13 +500,13 @@ const sidebarSettings = {
           link: { type: "doc", id: "docs/deploy/monitor-jobs" },
           items: [
             "docs/deploy/monitor-jobs",
-            "docs/deploy/run-visibility",
-            "docs/deploy/retry-jobs",
+            "docs/deploy/artifacts",
             "docs/deploy/job-notifications",
             "docs/deploy/model-notifications",
-            "docs/deploy/webhooks",
-            "docs/deploy/artifacts",
+            "docs/deploy/run-visibility",
+            "docs/deploy/retry-jobs",
             "docs/deploy/source-freshness",
+            "docs/deploy/webhooks",
           ],
         },
         "docs/deploy/deployment-tools",
@@ -524,12 +524,12 @@ const sidebarSettings = {
           link: { type: "doc", id: "docs/collaborate/explore-projects" },
           items: [
             "docs/collaborate/explore-projects",
-            "docs/collaborate/data-health-signals",
             "docs/collaborate/access-from-dbt-cloud",
             "docs/collaborate/column-level-lineage",
+            "docs/collaborate/data-health-signals",
+            "docs/collaborate/explore-multiple-projects",
             "docs/collaborate/model-performance",
             "docs/collaborate/project-recommendations",
-            "docs/collaborate/explore-multiple-projects",
             "docs/collaborate/dbt-explorer-faqs",
             {
               type: "category",
@@ -729,8 +729,8 @@ const sidebarSettings = {
           link: { type: "doc", id: "docs/dbt-cloud-apis/sl-api-overview" },
           items: [
             "docs/dbt-cloud-apis/sl-api-overview",
-            "docs/dbt-cloud-apis/sl-jdbc",
             "docs/dbt-cloud-apis/sl-graphql",
+            "docs/dbt-cloud-apis/sl-jdbc",
             "docs/dbt-cloud-apis/sl-python",
           ],
         },
@@ -851,18 +851,18 @@ const sidebarSettings = {
         "reference/project-configs/asset-paths",
         "reference/project-configs/clean-targets",
         "reference/project-configs/config-version",
-        "reference/project-configs/seed-paths",
         "reference/project-configs/dispatch-config",
         "reference/project-configs/docs-paths",
         "reference/project-configs/macro-paths",
-        "reference/project-configs/packages-install-path",
         "reference/project-configs/name",
         "reference/project-configs/on-run-start-on-run-end",
+        "reference/project-configs/packages-install-path",
         "reference/project-configs/profile",
         "reference/project-configs/query-comment",
         "reference/project-configs/quoting",
         "reference/project-configs/require-dbt-version",
         "reference/project-configs/snapshot-paths",
+        "reference/project-configs/seed-paths",
         "reference/project-configs/model-paths",
         "reference/project-configs/test-paths",
         "reference/project-configs/version",
@@ -926,27 +926,27 @@ const sidebarSettings = {
           type: "category",
           label: "General configs",
           items: [
+            "reference/advanced-config-usage",
             "reference/resource-configs/access",
             "reference/resource-configs/alias",
             "reference/resource-configs/batch-size",
             "reference/resource-configs/begin",
+            "reference/resource-configs/contract",
             "reference/resource-configs/database",
+            "reference/resource-configs/docs",
             "reference/resource-configs/enabled",
             "reference/resource-configs/event-time",
             "reference/resource-configs/full_refresh",
-            "reference/resource-configs/contract",
             "reference/resource-configs/grants",
             "reference/resource-configs/group",
-            "reference/resource-configs/docs",
             "reference/resource-configs/lookback",
+            "reference/resource-configs/meta",
             "reference/resource-configs/persist_docs",
+            "reference/resource-configs/plus-prefix",
             "reference/resource-configs/pre-hook-post-hook",
             "reference/resource-configs/schema",
             "reference/resource-configs/tags",
             "reference/resource-configs/unique_key",
-            "reference/resource-configs/meta",
-            "reference/advanced-config-usage",
-            "reference/resource-configs/plus-prefix",
           ],
         },
         {
@@ -956,10 +956,10 @@ const sidebarSettings = {
             "reference/model-properties",
             "reference/resource-properties/model_name",
             "reference/model-configs",
+            "reference/resource-properties/concurrent_batches",
             "reference/resource-configs/materialized",
             "reference/resource-configs/on_configuration_change",
             "reference/resource-configs/sql_header",
-            "reference/resource-properties/concurrent_batches",
           ],
         },
         {
@@ -1010,10 +1010,10 @@ const sidebarSettings = {
           items: [
             "reference/resource-properties/unit-tests",
             "reference/resource-properties/unit-test-input",
-            "reference/resource-properties/unit-testing-versions",
-            "reference/resource-properties/unit-test-overrides",
             "reference/resource-properties/data-formats",
             "reference/resource-properties/data-types",
+            "reference/resource-properties/unit-testing-versions",
+            "reference/resource-properties/unit-test-overrides",
           ],
         },
         {
@@ -1089,15 +1089,15 @@ const sidebarSettings = {
           label: "Node selection",
           items: [
             "reference/node-selection/syntax",
+            "reference/node-selection/exclude",
+            "reference/node-selection/defer",
             "reference/node-selection/graph-operators",
             "reference/node-selection/set-operators",
-            "reference/node-selection/exclude",
             "reference/node-selection/methods",
             "reference/node-selection/putting-it-together",
+            "reference/node-selection/state-comparison-caveats",
             "reference/node-selection/yaml-selectors",
             "reference/node-selection/test-selection-examples",
-            "reference/node-selection/defer",
-            "reference/node-selection/state-comparison-caveats",
           ],
         },
         {
@@ -1115,8 +1115,8 @@ const sidebarSettings = {
               link: { type: "doc", id: "reference/global-configs/adapter-behavior-changes" },
               items: [
                 "reference/global-configs/adapter-behavior-changes",
-                "reference/global-configs/databricks-changes",
                 "reference/global-configs/redshift-changes",
+                "reference/global-configs/databricks-changes",
               ],
             },
             {
@@ -1132,6 +1132,8 @@ const sidebarSettings = {
               type: "category",
               label: "Available flags",
               items: [
+                "reference/global-configs/usage-stats",
+                "reference/global-configs/version-compatibility",
                 "reference/global-configs/logs",
                 "reference/global-configs/cache",
                 "reference/global-configs/failing-fast",
@@ -1141,8 +1143,6 @@ const sidebarSettings = {
                 "reference/global-configs/print-output",
                 "reference/global-configs/record-timing-info",
                 "reference/global-configs/resource-type",
-                "reference/global-configs/usage-stats",
-                "reference/global-configs/version-compatibility",
                 "reference/global-configs/warnings",
               ],
             },
@@ -1183,9 +1183,9 @@ const sidebarSettings = {
       label: "dbt Artifacts",
       items: [
         "reference/artifacts/dbt-artifacts",
+        "reference/artifacts/catalog-json",
         "reference/artifacts/manifest-json",
         "reference/artifacts/run-results-json",
-        "reference/artifacts/catalog-json",
         "reference/artifacts/sources-json",
         "reference/artifacts/sl-manifest",
         "reference/artifacts/other-artifacts",