diff --git a/cloud_docs/concepts/deployments.md b/cloud_docs/concepts/deployments.md index cf7b8815..56a7b9dd 100644 --- a/cloud_docs/concepts/deployments.md +++ b/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. diff --git a/cloud_docs/guides/recover-from-a-failed-deploy.md b/cloud_docs/guides/recover-from-a-failed-deploy.md index cbc45f5d..e566ce89 100644 --- a/cloud_docs/guides/recover-from-a-failed-deploy.md +++ b/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. diff --git a/cloud_docs/reference/cli/_category_.json b/cloud_docs/reference/cli/_category_.json index 96bed6de..6936e2f4 100644 --- a/cloud_docs/reference/cli/_category_.json +++ b/cloud_docs/reference/cli/_category_.json @@ -1,6 +1,6 @@ { "label": "CLI", "collapsed": true, - "position": 3, + "position": 4, "className": "sidebar-icon-tools" } diff --git a/cloud_docs/reference/deployment/dart-sdk-versions.md b/cloud_docs/reference/dart-sdk-versions.md similarity index 92% rename from cloud_docs/reference/deployment/dart-sdk-versions.md rename to cloud_docs/reference/dart-sdk-versions.md index fbb3a3d3..647875d8 100644 --- a/cloud_docs/reference/deployment/dart-sdk-versions.md +++ b/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. diff --git a/cloud_docs/reference/deployment/_category_.json b/cloud_docs/reference/deployment/_category_.json deleted file mode 100644 index aa31dcaa..00000000 --- a/cloud_docs/reference/deployment/_category_.json +++ /dev/null @@ -1,6 +0,0 @@ -{ - "label": "Deployment", - "position": 1, - "collapsed": true, - "className": "sidebar-icon-deploying" -} diff --git a/cloud_docs/reference/deployment/handling-private-dependencies.md b/cloud_docs/reference/private-dependencies.md similarity index 92% rename from cloud_docs/reference/deployment/handling-private-dependencies.md rename to cloud_docs/reference/private-dependencies.md index 56e6e8b5..ac556025 100644 --- a/cloud_docs/reference/deployment/handling-private-dependencies.md +++ b/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: diff --git a/cloud_docs/reference/project-id.md b/cloud_docs/reference/project-id-rules.md similarity index 81% rename from cloud_docs/reference/project-id.md rename to cloud_docs/reference/project-id-rules.md index fb7e59dc..5eacf4cc 100644 --- a/cloud_docs/reference/project-id.md +++ b/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: diff --git a/docusaurus.config.js b/docusaurus.config.js index 9f1d2050..70112c00 100644 --- a/docusaurus.config.js +++ b/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', + }, ], }, ], diff --git a/src/css/custom.css b/src/css/custom.css index 57b70fe5..20f86268 100644 --- a/src/css/custom.css +++ b/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; }