docs: fix broken /docs/deployment/cloud/* links (#10936)

keydunov · cursoragent · web-flow · commit b9ae18217ef5 · 2026-05-22T10:06:40.000-07:00
The legacy paths /docs/deployment/cloud/{deployment-types,auto-suspension,
limits,scalability} now 404 on the live docs site, but were still used as
[ref-...] references throughout the docs and from external/cached links.

- Add redirects in docs.json from the four legacy paths to their current
  /admin/deployment/* counterparts.
- Rewrite internal [ref-...] references in 12 MDX files to use the new
  canonical /admin/deployment/* paths instead of going through redirects.

Co-authored-by: Cursor &lt;cursoragent@cursor.com&gt;
diff --git a/docs-mintlify/admin/account-billing/pricing.mdx b/docs-mintlify/admin/account-billing/pricing.mdx
@@ -319,12 +319,12 @@ for the AI token consumption at the **Billing** page of their Cube Cloud account
 
 [cube-pricing]: https://cube.dev/pricing
 [link-contact-us]: https://cube.dev/contact
-[ref-cloud-deployment-dev-instance]: /docs/deployment/cloud/deployment-types#shared
-[ref-cloud-deployment-prod-cluster]: /docs/deployment/cloud/deployment-types#dedicated
-[ref-cloud-limits]: /docs/deployment/cloud/limits
+[ref-cloud-deployment-dev-instance]: /admin/deployment/deployment-types#shared
+[ref-cloud-deployment-prod-cluster]: /admin/deployment/deployment-types#dedicated
+[ref-cloud-limits]: /admin/deployment/limits
 [ref-monitoring-integrations]: /docs/monitoring/integrations
 [ref-cloud-acl]: /admin/users-and-permissions/custom-roles
-[ref-cloud-deployment-prod-multicluster]: /docs/deployment/cloud/deployment-types#multi-cluster
+[ref-cloud-deployment-prod-multicluster]: /admin/deployment/deployment-types#multi-cluster
 [ref-cloud-custom-domains]: /docs/deployment/cloud/custom-domains
 [ref-cloud-vpc-peering]: /docs/deployment/cloud/vpc
 [ref-sls]: /docs/integrations/semantic-layer-sync
@@ -338,8 +338,8 @@ for the AI token consumption at the **Billing** page of their Cube Cloud account
 [ref-audit-log]: /admin/monitoring/audit-log
 [ref-dedicated-infra]: /docs/deployment/cloud/infrastructure#dedicated-infrastructure
 [ref-sso]: /docs/workspace/sso
-[ref-production-cluster]: /docs/deployment/cloud/deployment-types#dedicated
-[ref-development-instance]: /docs/deployment/cloud/deployment-types#shared
+[ref-production-cluster]: /admin/deployment/deployment-types#dedicated
+[ref-development-instance]: /admin/deployment/deployment-types#shared
 [ref-apis]: /reference
 [ref-mdx-api]: /reference/mdx-api
 [ref-dax-api]: /reference/dax-api
diff --git a/docs-mintlify/admin/deployment/auto-suspension.mdx b/docs-mintlify/admin/deployment/auto-suspension.mdx
@@ -114,9 +114,9 @@ longer in certain situations depending on two major factors:
 Complex data models take more time to compile, and complex queries can cause
 response times to be significantly longer than usual.
 
-[ref-deployment-dev-instance]: /docs/deployment/cloud/deployment-types#shared
-[ref-deployment-prod-cluster]: /docs/deployment/cloud/deployment-types#dedicated
-[ref-prod-multi-cluster]: /docs/deployment/cloud/deployment-types#multi-cluster
+[ref-deployment-dev-instance]: /admin/deployment/deployment-types#shared
+[ref-deployment-prod-cluster]: /admin/deployment/deployment-types#dedicated
+[ref-prod-multi-cluster]: /admin/deployment/deployment-types#multi-cluster
 [ref-deployment-pricing]: /admin/account-billing/pricing
 [ref-monitoring]: /admin/deployment/monitoring-integrations
 [ref-data-model]: /docs/data-modeling/overview
diff --git a/docs-mintlify/admin/deployment/deployment-types.mdx b/docs-mintlify/admin/deployment/deployment-types.mdx
@@ -158,9 +158,9 @@ To switch a deployment's type, go to the deployment's **Settings** screen
 and select from the available options.
 
 [ref-ctx-to-app-id]: /reference/configuration/config#context_to_app_id
-[ref-limits]: /docs/deployment/cloud/limits#resources
-[ref-scalability]: /docs/deployment/cloud/scalability
+[ref-limits]: /admin/deployment/limits#resources
+[ref-scalability]: /admin/deployment/scalability
 [ref-multitenancy]: /embedding/multitenancy
-[ref-auto-sus]: /docs/deployment/cloud/auto-suspension
+[ref-auto-sus]: /admin/deployment/auto-suspension
 [ref-refresh-worker]: /cube-core/architecture#refresh-worker
 [ref-dedicated-infra]: /admin/deployment/infrastructure#dedicated-infrastructure
diff --git a/docs-mintlify/admin/deployment/environments.mdx b/docs-mintlify/admin/deployment/environments.mdx
@@ -108,10 +108,10 @@ credentials**][ref-credentials].
 
 
 [ref-dev-mode]: /docs/data-modeling/dev-mode
-[ref-deployment-types]: /docs/deployment/cloud/deployment-types
-[ref-api-instance-scalability]: /docs/deployment/cloud/scalability#auto-scaling-of-api-instances
+[ref-deployment-types]: /admin/deployment/deployment-types
+[ref-api-instance-scalability]: /admin/deployment/scalability#auto-scaling-of-api-instances
 [ref-pricing-deployment-tiers]: /admin/account-billing/pricing
-[ref-suspend]: /docs/deployment/cloud/auto-suspension
+[ref-suspend]: /admin/deployment/auto-suspension
 [ref-overview]: /docs/workspace/integrations#review-integrations
 [ref-credentials]: /docs/workspace/integrations#view-api-credentials
 [ref-version]: /admin/deployment/index#cube-version
diff --git a/docs-mintlify/admin/deployment/index.mdx b/docs-mintlify/admin/deployment/index.mdx
@@ -185,9 +185,9 @@ resource consumption in different scenarios.
 
 
 [cube-cloud-signup]: https://cubecloud.dev/auth/signup
-[ref-deployment-types]: /docs/deployment/cloud/deployment-types
+[ref-deployment-types]: /admin/deployment/deployment-types
 [ref-dev-mode]: /docs/data-modeling/dev-mode
-[ref-auto-sus]: /docs/deployment/cloud/auto-suspension
+[ref-auto-sus]: /admin/deployment/auto-suspension
 [ref-total-cost]: /admin/account-billing/pricing#total-cost-examples
 [ref-data-source]: /admin/connect-to-data/data-sources
 [ref-duckdb]: /admin/connect-to-data/data-sources/duckdb
diff --git a/docs-mintlify/admin/deployment/limits.mdx b/docs-mintlify/admin/deployment/limits.mdx
@@ -97,12 +97,12 @@ response.
 
 [ref-rest-api]: /reference/rest-api
 [ref-gql-api]: /reference/graphql-api
-[ref-deployment-types]: /docs/deployment/cloud/deployment-types
+[ref-deployment-types]: /admin/deployment/deployment-types
 [ref-pricing]: /admin/account-billing/pricing
 [ref-query-history]: /admin/monitoring/query-history
 [ref-monitoring-integrations]: /admin/deployment/monitoring-integrations
-[ref-dev-instance]: /docs/deployment/cloud/deployment-types#shared
-[ref-prod-cluster]: /docs/deployment/cloud/deployment-types#dedicated
+[ref-dev-instance]: /admin/deployment/deployment-types#shared
+[ref-prod-cluster]: /admin/deployment/deployment-types#dedicated
 [cube-contact-us]: https://cube.dev/contact
 [ref-query-history-tiers]: /admin/account-billing/pricing#query-history-tiers
 [ref-audit-log]: /admin/monitoring/audit-log
diff --git a/docs-mintlify/admin/deployment/scalability.mdx b/docs-mintlify/admin/deployment/scalability.mdx
@@ -53,4 +53,4 @@ dropdown:
 </Frame>
 
 
-[ref-limits]: /docs/deployment/cloud/limits#resources
+[ref-limits]: /admin/deployment/limits#resources
diff --git a/docs-mintlify/admin/deployment/warm-up.mdx b/docs-mintlify/admin/deployment/warm-up.mdx
@@ -90,8 +90,8 @@ and enable **Warm-up pre-aggregations before deploying API**:
 </Frame>
 
 
-[ref-prod-cluster]: /docs/deployment/cloud/deployment-types#dedicated
-[ref-prod-multi-cluster]: /docs/deployment/cloud/deployment-types#multi-cluster
+[ref-prod-cluster]: /admin/deployment/deployment-types#dedicated
+[ref-prod-multi-cluster]: /admin/deployment/deployment-types#multi-cluster
 [ref-data-model]: /docs/data-modeling/overview
 [ref-dynamic-data-model]: /docs/data-modeling/dynamic
 [ref-multitenancy]: /embedding/multitenancy
diff --git a/docs-mintlify/admin/monitoring/monitoring-integrations/index.mdx b/docs-mintlify/admin/monitoring/monitoring-integrations/index.mdx
@@ -341,7 +341,7 @@ Query History export.
 </Note>
 
 
-[ref-autosuspend]: /docs/deployment/cloud/auto-suspension#effects-on-experience
+[ref-autosuspend]: /admin/deployment/auto-suspension#effects-on-experience
 [self-sinks-for-metrics]: #configuration-sinks-for-metrics
 [vector]: https://vector.dev/
 [vector-docs-config]: https://vector.dev/docs/reference/configuration/
diff --git a/docs-mintlify/admin/monitoring/performance.mdx b/docs-mintlify/admin/monitoring/performance.mdx
@@ -173,12 +173,12 @@ increase it until you see that there's no saturation and no wait time
 for queries and jobs.
 
 
-[ref-scalability-api]: /docs/deployment/cloud/scalability#auto-scaling-of-api-instances
-[ref-scalability-cube-store]: /docs/deployment/cloud/scalability#sizing-cube-store-workers
-[ref-auto-sus]: /docs/deployment/cloud/auto-suspension
-[ref-dev-instance]: /docs/deployment/cloud/deployment-types#shared
-[ref-prod-cluster]: /docs/deployment/cloud/deployment-types#dedicated
-[ref-multi-cluster]: /docs/deployment/cloud/deployment-types#multi-cluster
+[ref-scalability-api]: /admin/deployment/scalability#auto-scaling-of-api-instances
+[ref-scalability-cube-store]: /admin/deployment/scalability#sizing-cube-store-workers
+[ref-auto-sus]: /admin/deployment/auto-suspension
+[ref-dev-instance]: /admin/deployment/deployment-types#shared
+[ref-prod-cluster]: /admin/deployment/deployment-types#dedicated
+[ref-multi-cluster]: /admin/deployment/deployment-types#multi-cluster
 [ref-pre-aggregations]: /docs/pre-aggregations/using-pre-aggregations
 [ref-multitenancy]: /embedding/multitenancy
 [ref-context-to-app-id]: /reference/configuration/config#context_to_app_id
diff --git a/docs-mintlify/docs.json b/docs-mintlify/docs.json
@@ -815,6 +815,22 @@
     {
       "source": "/admin/deployment/vpc/gcp/byoc",
       "destination": "/admin/deployment/dedicated/gcp/byoc"
+    },
+    {
+      "source": "/docs/deployment/cloud/deployment-types",
+      "destination": "/admin/deployment/deployment-types"
+    },
+    {
+      "source": "/docs/deployment/cloud/auto-suspension",
+      "destination": "/admin/deployment/auto-suspension"
+    },
+    {
+      "source": "/docs/deployment/cloud/limits",
+      "destination": "/admin/deployment/limits"
+    },
+    {
+      "source": "/docs/deployment/cloud/scalability",
+      "destination": "/admin/deployment/scalability"
     }
   ]
 }
diff --git a/docs-mintlify/docs/integrations/semantic-layer-sync/index.mdx b/docs-mintlify/docs/integrations/semantic-layer-sync/index.mdx
@@ -370,4 +370,4 @@ on, i.e., your development mode branch, shared branch, or main branch.
 [ref-config-contexts]: /reference/configuration/config#scheduledrefreshcontexts
 [ref-config-schemaversion]: /reference/configuration/config#schema_version
 [ref-dev-mode]: /docs/data-modeling/dev-mode
-[ref-auto-sus]: /docs/deployment/cloud/auto-suspension
+[ref-auto-sus]: /admin/deployment/auto-suspension
diff --git a/docs-mintlify/docs/pre-aggregations/refreshing-pre-aggregations.mdx b/docs-mintlify/docs/pre-aggregations/refreshing-pre-aggregations.mdx
@@ -48,4 +48,4 @@ that would automatically do this for you.
 
 [ref-multitenancy]: /embedding/multitenancy
 [ref-preaggs]: /docs/pre-aggregations/using-pre-aggregations
-[ref-production-multi-cluster]: /docs/deployment/cloud/deployment-types#multi-cluster
+[ref-production-multi-cluster]: /admin/deployment/deployment-types#multi-cluster

Original file line number	Diff line number	Diff line change
`@@ -53,4 +53,4 @@ dropdown:`
`53`	`53`	`</Frame>`
`54`	`54`
`55`	`55`
`56`		`-[ref-limits]: /docs/deployment/cloud/limits#resources`
	`56`	`+[ref-limits]: /admin/deployment/limits#resources`