docs(cloud): Establish Reference section by moving and renaming the three existing pages

cloud_docs/concepts/deployments.md

@@ -161,6 +161,6 @@ For a step-by-step walkthrough, see [Recover from a failed deploy](/cloud/guides
 ## Related
 
 - [Deployment hooks](/cloud/concepts/deployment-hooks) for pre- and post-deploy automation.
-- [Handling private dependencies](/cloud/reference/deployment/handling-private-dependencies) for private package access during the build.
+- [Private dependencies](/cloud/reference/private-dependencies) for private package access during the build.
 - [Ship non-Dart files with your server](/cloud/guides/ship-non-dart-files) for shipping static assets like configuration and templates.
 - [Deploy from CI with GitHub Actions](/cloud/guides/deploy-from-ci-with-github-actions) for shipping every push.

cloud_docs/guides/recover-from-a-failed-deploy.md

@@ -67,7 +67,7 @@ scloud deploy --timeout 120s
 
 If the timeout keeps tripping at high values, the issue is likely upstream (network or Cloud-side); retry later.
 
-**Package resolution failure.** Cloud can't resolve your `pubspec.yaml`. Run `dart pub get` locally to reproduce the error, fix the pubspec (mismatched versions, missing packages, private dependencies that aren't configured), and redeploy. For private packages, see [Handling private dependencies](/cloud/reference/deployment/handling-private-dependencies).
+**Package resolution failure.** Cloud can't resolve your `pubspec.yaml`. Run `dart pub get` locally to reproduce the error, fix the pubspec (mismatched versions, missing packages, private dependencies that aren't configured), and redeploy. For private packages, see [Private dependencies](/cloud/reference/private-dependencies).
 
 **Build failure.** Lines beginning with `ERROR:` or `FAILED:` in the build log, usually pointing at a Dart compile error, a missing import, or a missing dependency. Fix the file in your project, commit, and redeploy.
 

cloud_docs/reference/cli/_category_.json

@@ -1,6 +1,6 @@
 {
   "label": "CLI",
   "collapsed": true,
-  "position": 3,
+  "position": 4,
   "className": "sidebar-icon-tools"
 }

cloud_docs/reference/deployment/dart-sdk-versions.md → cloud_docs/reference/dart-sdk-versions.md

@@ -1,8 +1,10 @@
 ---
-sidebar_position: 2
+sidebar_position: 1
+title: Dart SDK versions
+description: Which Dart SDK versions Serverpod Cloud supports, how the SDK version is selected for your build, and how to pin a version in pubspec.yaml.
 ---
 
-# Dart SDK version handling
+# Dart SDK versions
 
 Serverpod Cloud supports specific Dart SDK versions for building and deploying your applications. Understanding how SDK versions are determined and used is important for configuring your project correctly.
 
@@ -174,4 +176,4 @@ environment:
 ## Related documentation
 
 - [Deployments](/cloud/concepts/deployments) - Deploy operations, status checks, package validation, and `.scloudignore` configuration.
-- [Handling private dependencies](/cloud/reference/deployment/handling-private-dependencies) for managing workspace dependencies.
+- [Private dependencies](/cloud/reference/private-dependencies) for managing workspace dependencies.

cloud_docs/reference/deployment/handling-private-dependencies.md → cloud_docs/reference/private-dependencies.md

@@ -1,8 +1,10 @@
 ---
-sidebar_position: 1
+sidebar_position: 2
+title: Private dependencies
+description: How to deploy a Serverpod Cloud project that depends on private packages, using Dart workspaces or build secrets for private git repositories.
 ---
 
-# Handling private dependencies
+# Private dependencies
 
 Serverpod Cloud supports deploying your project with private dependencies.
 The typical methods are:

cloud_docs/reference/project-id.md → cloud_docs/reference/project-id-rules.md

@@ -1,9 +1,10 @@
 ---
-sidebar_position: 2
-title: Project identifier
+sidebar_position: 3
+title: Project identifier rules
+description: "Naming rules for the Serverpod Cloud project identifier and how scloud picks which project to operate on: scloud.yaml, -p flag, or environment variable."
 ---
 
-# Project identifier
+# Project identifier rules
 
 The identifier given to a project in Serverpod Cloud must adhere to these rules:
 

docusaurus.config.js

@@ -253,6 +253,18 @@ const config = {
             from: ['/cloud/reference/deployment/github-automation'],
             to: '/cloud/guides/deploy-from-ci-with-github-actions',
           },
+          {
+            from: ['/cloud/reference/deployment/handling-private-dependencies'],
+            to: '/cloud/reference/private-dependencies',
+          },
+          {
+            from: ['/cloud/reference/deployment/dart-sdk-versions'],
+            to: '/cloud/reference/dart-sdk-versions',
+          },
+          {
+            from: ['/cloud/reference/project-id'],
+            to: '/cloud/reference/project-id-rules',
+          },
         ],
       },
     ],

src/css/custom.css

@@ -466,7 +466,8 @@ a.navbar__link svg use[href="#theme-svg-external-link"] {
   --sidebar-icon-color: currentColor;
 }
 
-.theme-doc-sidebar-menu .sidebar-icon-overview .menu__link {
+.theme-doc-sidebar-menu .sidebar-icon-overview > .menu__link,
+.theme-doc-sidebar-menu .sidebar-icon-overview > div.menu__list-item-collapsible > a.menu__link--sublist {
   --sidebar-icon-mask: url('/img/sidebar-icon-compass.svg');
   --sidebar-icon-color: currentColor;
 }