docs: restructure cloud section

PR-URL: https://github.com/hasura/graphql-engine-mono/pull/9672
Co-authored-by: Sean Park-Ross <94021366+seanparkross@users.noreply.github.com>
GitOrigin-RevId: 16a90fb86885532bf63925766a492139d1dbab12

docs/docs/cloud-ci-cd/_category_.json

@@ -0,0 +1,5 @@
+{
+  "label": "GitHub integrations",
+  "position": 83,
+  "className": "cloud-icon"
+}

docs/docs/cloud-ci-cd/github-integration.mdx

@@ -9,7 +9,7 @@ keywords:
   - deployment
   - git
 sidebar_label: GitHub deployment
-sidebar_position: 20
+sidebar_position: 2
 ---
 
 import Thumbnail from '@site/src/components/Thumbnail';

docs/docs/cloud-ci-cd/index.mdx

@@ -25,7 +25,7 @@ repo by triggering a new deployment. These features are intended to improve the
 
 Hasura Cloud can automatically detect Metadata and Migration changes in a linked GitHub repo and deploy these changes to
 the linked project. Read more on how to add this integration in your project
-[here](/hasura-cloud/ci-cd/github-integration.mdx).
+[here](/cloud-ci-cd/github-integration.mdx).
 
 ## Hasura Cloud Preview Apps
 
@@ -34,8 +34,8 @@ App on each pull request in order to automatically preview changes.
 
 This can be achieved using either of the following:
 
-- [Preview App GitHub Action](/hasura-cloud/ci-cd/preview-apps.mdx#preview-apps-github-action)
+- [Preview App GitHub Action](/cloud-ci-cd/preview-apps.mdx#preview-apps-github-action)
-- [Preview App APIs](/hasura-cloud/ci-cd/preview-apps.mdx#preview-apps-api)
+- [Preview App APIs](/cloud-ci-cd/preview-apps.mdx#preview-apps-api)
 
 :::info Note
 

docs/docs/cloud-ci-cd/one-click-deploy/_category_.json

@@ -0,0 +1,4 @@
+{
+  "label": "One Click Deployment",
+  "position": 4
+}

docs/docs/cloud-ci-cd/one-click-deploy/create-one-click-to-deploy-apps.mdx

@@ -223,7 +223,7 @@ The `Deploy to Hasura Cloud` button image asset can be found [here](https://hasu
 ## Step 5: Verify Deployment URL
 
 Once the One Click Deploy URL is generated, verify the link by executing the One Click Deploy workflow as described
-[here](./index.mdx).
+[here](index.mdx).
 
 ## Troubleshooting your app
 

docs/docs/cloud-ci-cd/one-click-deploy/index.mdx

@@ -24,7 +24,7 @@ they can try them out instantly on Hasura Cloud.
 :::info Try it out
 
 - Try deploying some sample apps from the [Hasura Hub](https://hasura.io/hub/).
-- [Create a One Click Deploy app](./create-one-click-to-deploy-apps.mdx) to share your Hasura application.
+- [Create a One Click Deploy app](create-one-click-to-deploy-apps.mdx) to share your Hasura application.
 
 :::
 

docs/docs/cloud-ci-cd/preview-apps.mdx

@@ -11,7 +11,7 @@ keywords:
   - pull request
   - GitHub
 sidebar_label: Preview Apps
-sidebar_position: 10
+sidebar_position: 3
 ---
 
 import Thumbnail from '@site/src/components/Thumbnail';

docs/docs/databases/ms-sql-server/mssql.mdx

@@ -176,7 +176,7 @@ Voilà. You are ready to start developing.
 
 - If using Hasura Cloud, you can also click the gear icon to manage your Hasura Cloud project. (e.g. add
   [collaborators](/hasura-cloud/projects/collaborators.mdx), [env vars](/hasura-cloud/projects/env-vars.mdx) or
-  [custom domains](/hasura-cloud/projects/domains.mdx)).
+  [custom domains](/hasura-cloud/domains.mdx)).
 
 <Thumbnail src="/img/getting-started/project-manage.png" alt="Project actions" width="860px" />
 

docs/docs/databases/postgres/aiven.mdx

@@ -152,7 +152,7 @@ Voilà. You are ready to start developing.
 
 - If using Hasura Cloud, you can also click the gear icon to manage your Hasura Cloud project. (e.g. add
   [collaborators](/hasura-cloud/projects/collaborators.mdx), [env vars](/hasura-cloud/projects/env-vars.mdx) or
-  [custom domains](/hasura-cloud/projects/domains.mdx)).
+  [custom domains](/hasura-cloud/domains.mdx)).
 
 <Thumbnail src="/img/getting-started/project-manage.png" alt="Project actions" width="860px" />
 

docs/docs/databases/postgres/alloy.mdx

@@ -227,7 +227,7 @@ Voilà. You are ready to start developing.
 
 - If using Hasura Cloud, you can also click the gear icon to manage your Hasura Cloud project. (e.g. add
   [collaborators](/hasura-cloud/projects/collaborators.mdx), [env vars](/hasura-cloud/projects/env-vars.mdx) or
-  [custom domains](/hasura-cloud/projects/domains.mdx)).
+  [custom domains](/hasura-cloud/domains.mdx)).
 
 <Thumbnail src="/img/getting-started/project-manage.png" alt="Project actions" width="860px" />
 

docs/docs/databases/postgres/aws-aurora.mdx

@@ -197,7 +197,7 @@ Voilà. You are ready to start developing.
 
 - If using Hasura Cloud, you can also click the gear icon to manage your Hasura Cloud project. (e.g. add
   [collaborators](/hasura-cloud/projects/collaborators.mdx), [env vars](/hasura-cloud/projects/env-vars.mdx) or
-  [custom domains](/hasura-cloud/projects/domains.mdx)).
+  [custom domains](/hasura-cloud/domains.mdx)).
 
 <Thumbnail src="/img/getting-started/project-manage.png" alt="Project actions" width="860px" />
 

docs/docs/databases/postgres/aws-postgres.mdx

@@ -196,7 +196,7 @@ Voilà. You are ready to start developing.
 
 - If using Hasura Cloud, you can also click the gear icon to manage your Hasura Cloud project. (e.g. add
   [collaborators](/hasura-cloud/projects/collaborators.mdx), [env vars](/hasura-cloud/projects/env-vars.mdx) or
-  [custom domains](/hasura-cloud/projects/domains.mdx)).
+  [custom domains](/hasura-cloud/domains.mdx)).
 
 <Thumbnail src="/img/getting-started/project-manage.png" alt="Project actions" width="860px" />
 

docs/docs/databases/postgres/azure-cosmos.mdx

@@ -110,7 +110,7 @@ Voilà. You are ready to start developing.
 - If using Hasura Cloud, you can also click the gear icon to manage your Hasura Cloud project. (e.g. add
   [collaborators](/hasura-cloud/projects/collaborators.mdx#manage-project-collaborators),
   [env vars](/hasura-cloud/projects/env-vars.mdx#manage-project-env-vars) or
-  [custom domains](/hasura-cloud/projects/domains.mdx#manage-project-domains)).
+  [custom domains](/hasura-cloud/domains.mdx#manage-project-domains)).
 
 <Thumbnail src="/img/getting-started/project-manage.png" alt="Project actions" width="860px" />
 

docs/docs/databases/postgres/azure.mdx

@@ -164,7 +164,7 @@ Voilà. You are ready to start developing.
 - If using Hasura Cloud, you can also click the gear icon to manage your Hasura Cloud project. (e.g. add
   [collaborators](/hasura-cloud/projects/collaborators.mdx#manage-project-collaborators),
   [env vars](/hasura-cloud/projects/env-vars.mdx#manage-project-env-vars) or
-  [custom domains](/hasura-cloud/projects/domains.mdx#manage-project-domains)).
+  [custom domains](/hasura-cloud/domains.mdx#manage-project-domains)).
 
 <Thumbnail src="/img/getting-started/project-manage.png" alt="Project actions" width="860px" />
 

docs/docs/databases/postgres/crunchy.mdx

@@ -140,7 +140,7 @@ Voilà. You are ready to start developing.
 - If using Hasura Cloud, you can also click the gear icon to manage your Hasura Cloud project. (e.g. add
   [collaborators](/hasura-cloud/projects/collaborators.mdx#manage-project-collaborators),
   [env vars](/hasura-cloud/projects/env-vars.mdx#manage-project-env-vars) or
-  [custom domains](/hasura-cloud/projects/domains.mdx#manage-project-domains)).
+  [custom domains](/hasura-cloud/domains.mdx#manage-project-domains)).
 
 <Thumbnail src="/img/getting-started/project-manage.png" alt="Project actions" width="860px" />
 

docs/docs/databases/postgres/digital-ocean.mdx

@@ -153,7 +153,7 @@ Voilà. You are ready to start developing.
 - If using Hasura Cloud, you can also click the gear icon to manage your Hasura Cloud project. (e.g. add
   [collaborators](/hasura-cloud/projects/collaborators.mdx#manage-project-collaborators),
   [env vars](/hasura-cloud/projects/env-vars.mdx#manage-project-env-vars) or
-  [custom domains](/hasura-cloud/projects/domains.mdx#manage-project-domains)).
+  [custom domains](/hasura-cloud/domains.mdx#manage-project-domains)).
 
 <Thumbnail src="/img/getting-started/project-manage.png" alt="Project actions" width="860px" />
 

docs/docs/databases/postgres/elephant.mdx

@@ -140,7 +140,7 @@ Voilà. You are ready to start developing.
 - If using Hasura Cloud, you can also click the gear icon to manage your Hasura Cloud project. (e.g. add
   [collaborators](/hasura-cloud/projects/collaborators.mdx#manage-project-collaborators),
   [env vars](/hasura-cloud/projects/env-vars.mdx#manage-project-env-vars) or
-  [custom domains](/hasura-cloud/projects/domains.mdx#manage-project-domains)).
+  [custom domains](/hasura-cloud/domains.mdx#manage-project-domains)).
 
 <Thumbnail src="/img/getting-started/project-manage.png" alt="Project actions" width="860px" />
 

docs/docs/databases/postgres/enterprisedb.mdx

@@ -169,7 +169,7 @@ Voilà. You are ready to start developing.
 - If using Hasura Cloud, you can also click the gear icon to manage your Hasura Cloud project. (e.g. add
   [collaborators](/hasura-cloud/projects/collaborators.mdx#manage-project-collaborators),
   [env vars](/hasura-cloud/projects/env-vars.mdx#manage-project-env-vars) or
-  [custom domains](/hasura-cloud/projects/domains.mdx#manage-project-domains)).
+  [custom domains](/hasura-cloud/domains.mdx#manage-project-domains)).
 
 <Thumbnail src="/img/getting-started/project-manage.png" alt="Project actions" width="860px" />
 

docs/docs/databases/postgres/gcp.mdx

@@ -217,7 +217,7 @@ Finally, click on the `Update Connection` button to apply the SSL settings.
 
 - If using Hasura Cloud, you can also click the gear icon to manage your Hasura Cloud project. (e.g. add
   [collaborators](/hasura-cloud/projects/collaborators.mdx), [env vars](/hasura-cloud/projects/env-vars.mdx) or
-  [custom domains](/hasura-cloud/projects/domains.mdx)).
+  [custom domains](/hasura-cloud/domains.mdx)).
 
 <Thumbnail src="/img/getting-started/project-manage.png" alt="Project actions" width="860px" />
 

docs/docs/databases/postgres/heroku.mdx

@@ -33,7 +33,7 @@ or migrate your database to a new database provider.
 ## Connecting to Heroku
 
 If you are interested in connecting to a Heroku database, our
-[Heroku database integration guide](/hasura-cloud/projects/heroku-url-sync.mdx) walks you through each step.
+[Heroku database integration guide](/hasura-cloud/heroku-url-sync.mdx) walks you through each step.
 
 ## Alternatives to Heroku
 
@@ -75,7 +75,7 @@ to help you:
   </a> or move to a different database provider. Heroku also appears to not be responding to questions from free-tier users.
   <br />
   <br />
-  If you have URL sync enabled via our <a href={'/latest/hasura-cloud/projects/heroku-url-sync/'}>Heroku integration</a>
+  If you have URL sync enabled via our <a href={'/latest/hasura-cloud/heroku-url-sync/'}>Heroku integration</a>
   , you can follow{' '}
   <a href={'https://devcenter.heroku.com/articles/upgrading-heroku-postgres-databases#upgrading-with-pg-copy'}>
     these steps
@@ -90,7 +90,7 @@ to help you:
 
 <details>
   <summary>How do I add an existing paid database to my Hasura Project?</summary>
-  Please follow the <a href={'/latest/hasura-cloud/projects/heroku-url-sync/'}>integration guide here</a>.
+  Please follow the <a href={'/latest/hasura-cloud/heroku-url-sync/'}>integration guide here</a>.
 </details>
 
 <details>

docs/docs/databases/postgres/railway.mdx

@@ -122,7 +122,7 @@ Voilà. You are ready to start developing.
 - If using Hasura Cloud, you can also click the gear icon to manage your Hasura Cloud project. (e.g. add
   [collaborators](/hasura-cloud/projects/collaborators.mdx#manage-project-collaborators),
   [env vars](/hasura-cloud/projects/env-vars.mdx#manage-project-env-vars) or
-  [custom domains](/hasura-cloud/projects/domains.mdx#manage-project-domains)).
+  [custom domains](/hasura-cloud/domains.mdx#manage-project-domains)).
 
 <Thumbnail src="/img/getting-started/project-manage.png" alt="Project actions" width="860px" />
 

docs/docs/databases/postgres/render.mdx

@@ -113,7 +113,7 @@ Voilà. You are ready to start developing.
 - If using Hasura Cloud, you can also click the gear icon to manage your Hasura Cloud project. (e.g. add
   [collaborators](/hasura-cloud/projects/collaborators.mdx#manage-project-collaborators),
   [env vars](/hasura-cloud/projects/env-vars.mdx#manage-project-env-vars) or
-  [custom domains](/hasura-cloud/projects/domains.mdx#manage-project-domains)).
+  [custom domains](/hasura-cloud/domains.mdx#manage-project-domains)).
 
 <Thumbnail src="/img/getting-started/project-manage.png" alt="Project actions" width="860px" />
 

docs/docs/databases/postgres/supabase.mdx

@@ -172,7 +172,7 @@ Voilà. You are ready to start developing.
 - If using Hasura Cloud, you can also click the gear icon to manage your Hasura Cloud project. (e.g. add
   [collaborators](/hasura-cloud/projects/collaborators.mdx#manage-project-collaborators),
   [env vars](/hasura-cloud/projects/env-vars.mdx#manage-project-env-vars) or
-  [custom domains](/hasura-cloud/projects/domains.mdx#manage-project-domains)).
+  [custom domains](/hasura-cloud/domains.mdx#manage-project-domains)).
 
 <Thumbnail src="/img/getting-started/project-manage.png" alt="Project actions" width="860px" />
 

docs/docs/databases/postgres/timescale-cloud.mdx

@@ -148,7 +148,7 @@ Voilà. You are ready to start developing.
 
 - If using Hasura Cloud, you can also click the gear icon to manage your Hasura Cloud project. (e.g. add
   [collaborators](/hasura-cloud/projects/collaborators.mdx), [env vars](/hasura-cloud/projects/env-vars.mdx) or
-  [custom domains](/hasura-cloud/projects/domains.mdx)).
+  [custom domains](/hasura-cloud/domains.mdx)).
 
 <Thumbnail src="/img/getting-started/project-manage.png" alt="Project actions" width="860px" />
 

docs/docs/databases/postgres/yugabyte.mdx

@@ -167,7 +167,7 @@ Voilà. You are ready to start developing.
 
 - If using Hasura Cloud, you can also click the gear icon to manage your Hasura Cloud project. (e.g. add
   [collaborators](/hasura-cloud/projects/collaborators.mdx), [env vars](/hasura-cloud/projects/env-vars.mdx) or
-  [custom domains](/hasura-cloud/projects/domains.mdx)).
+  [custom domains](/hasura-cloud/domains.mdx)).
 
 <Thumbnail src="/img/getting-started/project-manage.png" alt="Project actions" width="860px" />
 

docs/docs/deployment/health-checks/_category_.json

@@ -1,4 +1,4 @@
 {
   "label": "Health Checks",
-  "position": 50
+  "position": 51
 }

docs/docs/deployment/health-checks/source-health-check.mdx

@@ -9,7 +9,7 @@ keywords:
   - source health
 sidebar_label: Source Health Check
 sidebar_position: 20
-sidebar_class_name: cloud-icon
+sidebar_class_name: cloud-and-enterprise-icon
 ---
 
 import Tabs from '@theme/Tabs';

docs/docs/deployment/regression-tests.mdx

@@ -8,13 +8,14 @@ keywords:
   - regression
   - migration
 sidebar_label: Regression tests
-sidebar_position: 50
+sidebar_position: 101
+sidebar_class_name: cloud-icon
 ---
 
 import Thumbnail from '@site/src/components/Thumbnail';
 import ProductBadge from '@site/src/components/ProductBadge';
 
-# Regression Tests
+# Regression Tests on Hasura Cloud
 
 <ProductBadge free standard pro ee />
 

docs/docs/faq.mdx

@@ -136,7 +136,7 @@ or a similar CI/CD service to build a custom deployment pipeline for your Hasura
 
 ## How can I preview changes to my Hasura instance?
 
-With [Preview Apps](/hasura-cloud/ci-cd/preview-apps.mdx) on Hasura Cloud you can automatically create an app on Hasura
+With [Preview Apps](/cloud-ci-cd/preview-apps.mdx) on Hasura Cloud you can automatically create an app on Hasura
 Cloud for every pull request you make to your GitHub repo enabling quick and easy testing of changes as you work.
 
 ## How would I work collaboratively with my team using Hasura?

docs/docs/getting-started/getting-started-cloud.mdx

@@ -169,6 +169,6 @@ There are several options for the implementation of business logic, depending on
 
 You can click the gear icon in the Hasura Cloud dashboard to manage your Hasura Cloud project (e.g. add
 [collaborators](/hasura-cloud/projects/collaborators.mdx), [env vars](/hasura-cloud/projects/env-vars.mdx) or
-[custom domains](/hasura-cloud/projects/domains.mdx)).
+[custom domains](/hasura-cloud/domains.mdx)).
 
 <Thumbnail src="/img/getting-started/project-manage.png" alt="Project actions" width="860px" />

docs/docs/hasura-cli/pro-cli/regression-tests.mdx

@@ -21,7 +21,7 @@ You can temporarily spin up a Hasura instance and then point the CLI to that ins
 
 Before you can run tests, a test suite needs to be set up with operations that have been captured on your Hasura Project.
 
-You can read more about setting up a test suite [here](/hasura-cloud/regression-tests.mdx#manage-test-suites).
+You can read more about setting up a test suite [here](/deployment/regression-tests.mdx#manage-test-suites).
 
 ## Getting a personal access token
 

docs/docs/hasura-cli/quickstart.mdx

@@ -199,7 +199,7 @@ deploying to, you'll need to use a different method. You can pick up right where
 ## Step 7: Deploy to another environment
 
 If you're deploying to Hasura Cloud, you can use the Hasura CLI or our
-[GitHub integration](/hasura-cloud/ci-cd/github-integration.mdx). If you're deploying to a different environment, you'll
+[GitHub integration](/cloud-ci-cd/github-integration.mdx). If you're deploying to a different environment, you'll
 need to use the Hasura CLI.
 
 ### Deploy to Hasura Cloud
@@ -217,7 +217,7 @@ git push -u origin main
 ```
 
 From here, you can follow the instructions in the
-[GitHub integration guide](/hasura-cloud/ci-cd/github-integration.mdx#initial-setup) to deploy your project to Hasura
+[GitHub integration guide](/cloud-ci-cd/github-integration.mdx#initial-setup) to deploy your project to Hasura
 Cloud. With this connection in place, you can iterate and develop your project locally - and then push your changes to
 GitHub to deploy to Hasura Cloud 🎉
 
@@ -226,7 +226,7 @@ Head down to the [recap section](#recap) to learn more about some of the design
 :::info Curious about testing your changes?
 
 Hasura Cloud can be used as a staging or production environment. If you're curious about testing your project in a
-staging environment, consider our [Preview Apps](/hasura-cloud/ci-cd/preview-apps.mdx) feature.
+staging environment, consider our [Preview Apps](/cloud-ci-cd/preview-apps.mdx) feature.
 
 :::
 

docs/docs/hasura-cloud/account-management/_category_.json

@@ -1,5 +1,4 @@
 {
-  "label": "Account management ",
+  "label": "Account management",
-  "position": 30,
+  "position": 30
-  "className": "cloud-icon"
 }

docs/docs/hasura-cloud/account-management/billing/_category_.json

@@ -1,5 +1,4 @@
 {
   "label": "Billing ",
-  "position": 20,
+  "position": 20
-  "className": "cloud-icon"
 }

docs/docs/hasura-cloud/ci-cd/_category_.json

@@ -1,4 +0,0 @@
-{
-  "label": "CI/CD",
-  "position": 40
-}

docs/docs/hasura-cloud/disaster-recovery.mdx

@@ -43,7 +43,7 @@ with your secondary database.
 
 Depending on when and how you keep the secondary database schema and data synced with the primary database, you should
 also keep the Hasura Metadata on the secondary project up-to-date and in-sync with the primary project. You can use our
-[Github Integration](/hasura-cloud/ci-cd/github-integration.mdx) features to keep your secondary project in-sync by
+[Github Integration](/cloud-ci-cd/github-integration.mdx) features to keep your secondary project in-sync by
 deploying each commit to both projects. Care should be taken in the config of databases and ENV variables in this
 regard.
 

docs/docs/hasura-cloud/domains.mdx

@@ -1,26 +1,27 @@
 ---
-description: Managing domains on Hasura Cloud
+description: Managing custom domains on Hasura Cloud
-title: 'Cloud: Project Domains'
+title: 'Cloud: Custom Project Domains'
 keywords:
   - hasura
   - docs
   - project
   - domains
-sidebar_position: 7
+sidebar_position: 32
-sidebar_label: Manage domains
+sidebar_label: Custom domains
 ---
 
 import Thumbnail from '@site/src/components/Thumbnail';
 import HeadingIcon from '@site/src/components/HeadingIcon';
 import ProductBadge from '@site/src/components/ProductBadge';
 
-# Project Domains
+# Custom Domains
 
 <ProductBadge standard pro ee />
 
 ## Introduction
 
-In the `Domains` tab, you can see the default Hasura domain, and you have the possibility to add custom domains.
+In the `Domains` tab of your Project, you can see the default Hasura domain, and you have the possibility to add custom
+domains.
 
 ## Adding a custom domain
 

docs/docs/hasura-cloud/environments.mdx

@@ -11,7 +11,7 @@ keywords:
   - production
   - environment
 sidebar_label: Manage development environments
-sidebar_position: 11
+sidebar_position: 33
 ---
 
 import HeadingIcon from '@site/src/components/HeadingIcon';
@@ -105,7 +105,7 @@ Also add any other ENV vars that you might have set on your local project.
 ### Setting up a Git repo for your Hasura Project
 
 In order to easily apply your local changes to your new Cloud project, we'll use the Hasura
-[GitHub deployment](/hasura-cloud/ci-cd/github-integration.mdx) feature. But before we do that, we need to setup
+[GitHub deployment](/cloud-ci-cd/github-integration.mdx) feature. But before we do that, we need to setup
 Metadata & Migrations of your local setup that you can apply to your Cloud project. For a lowdown on Hasura Metadata &
 Migrations refer the guide [here](/migrations-metadata-seeds/overview.mdx)
 
@@ -157,4 +157,4 @@ git commit -m "initialize metadata and migrations"
 Push these changes to GitHub repo of your choice.
 
 Now we're all set to see the magic of our GitHub integration to deploy the Metadata and Migrations to your Cloud project
-by following the steps [here](/hasura-cloud/ci-cd/github-integration.mdx)!
+by following the steps [here](/cloud-ci-cd/github-integration.mdx)!

docs/docs/hasura-cloud/graphql-api-explorer.mdx

@@ -12,7 +12,6 @@ keywords:
   - graphiQL
 sidebar_label: GraphQL API Explorer
 sidebar_position: 90
-sidebar_class_name: cloud-icon
 # adding index slug in case this root doc becomes a directory later
 slug: graphql-api-explorer/index
 ---

docs/docs/hasura-cloud/heroku-url-sync.mdx

@@ -9,7 +9,7 @@ keywords:
   - heroku
   - database url
   - sync
-sidebar_position: 12
+sidebar_position: 35
 sidebar_label: Heroku URL sync
 ---
 

docs/docs/hasura-cloud/one-click-deploy/_category_.json

@@ -1,4 +0,0 @@
-{
-  "label": "One Click Deploy to Hasura Cloud",
-  "position": 15
-}

docs/docs/hasura-cloud/overview.mdx

@@ -50,7 +50,7 @@ import Cloud from '@site/static/icons/features/cloud.svg';
 ## Using Hasura Cloud
 
 <div className="overview-gallery">
-  <VersionedLink to="/hasura-cloud/one-click-deploy/index/">
+  <VersionedLink to="/cloud-ci-cd/one-click-deploy/index/">
     <div className="card">
       <h3>One Click Deployments</h3>
       <p>
@@ -59,7 +59,7 @@ import Cloud from '@site/static/icons/features/cloud.svg';
       </p>
     </div>
   </VersionedLink>
-  <VersionedLink to="/hasura-cloud/ci-cd/github-integration/">
+  <VersionedLink to="/cloud-ci-cd/github-integration/">
     <div className="card">
       <h3>GitHub Integration</h3>
       <p>
@@ -156,10 +156,10 @@ import Cloud from '@site/static/icons/features/cloud.svg';
       <VersionedLink to="/hasura-cloud/regions/">Cloud providers: AWS, Google Cloud</VersionedLink>
     </li>
     <li>
-      <VersionedLink to="/hasura-cloud/ci-cd/github-integration/">GitHub integration</VersionedLink>
+      <VersionedLink to="/cloud-ci-cd/github-integration/">GitHub integration</VersionedLink>
     </li>
     <li>
-      <VersionedLink to="/hasura-cloud/ci-cd/preview-apps/">Preview apps</VersionedLink>
+      <VersionedLink to="/cloud-ci-cd/preview-apps/">Preview apps</VersionedLink>
     </li>
     <li>
       <a href="https://hasura.io/help/">Community support</a>
@@ -245,7 +245,7 @@ import Cloud from '@site/static/icons/features/cloud.svg';
       </VersionedLink>
     </li>
     <li>
-      <VersionedLink to="/hasura-cloud/projects/domains/#adding-a-custom-domain">
+      <VersionedLink to="/hasura-cloud/domains/#adding-a-custom-domain">
         Custom domain (DNS CNAME)
       </VersionedLink>
     </li>

docs/docs/hasura-cloud/projects/_category_.json

@@ -1,5 +1,4 @@
 {
   "label": "Projects & collaborators ",
-  "position": 20,
+  "position": 20
-  "className": "cloud-icon"
 }

docs/docs/hasura-cloud/projects/index.mdx

@@ -65,13 +65,13 @@ programmatically.
 - [Project Collaborators](/hasura-cloud/projects/collaborators.mdx)
 - [Transfer Ownership](/hasura-cloud/projects/ownership.mdx)
 - [Project Env vars](/hasura-cloud/projects/env-vars.mdx)
-- [Project Domains](/hasura-cloud/projects/domains.mdx)
+- [Project Domains](/hasura-cloud/domains.mdx)
+- [Managing development environments](/hasura-cloud/environments.mdx)
 - [Securing projects](/hasura-cloud/projects/secure.mdx)
 - [Switching pricing plans](/hasura-cloud/projects/pricing.mdx)
 - [Deployment regions](/hasura-cloud/projects/regions.mdx)
-- [Managing development environments](/hasura-cloud/projects/environments.mdx)
+- [Heroku database integration](/hasura-cloud/heroku-url-sync.mdx)
-- [Heroku database integration](/hasura-cloud/projects/heroku-url-sync.mdx)
+- [Vercel Integration](/hasura-cloud/vercel-integration.mdx)
-- [Vercel Integration](/hasura-cloud/projects/vercel-integration.mdx)
 - [Maintenance mode](/hasura-cloud/projects/maintenance-mode.mdx)
 - [Deleting projects](/hasura-cloud/projects/delete.mdx)
 - [Updating v1.3 projects to v2.0](/hasura-cloud/projects/move-project-v2.mdx)

docs/docs/hasura-cloud/projects/maintenance-mode.mdx

@@ -55,7 +55,7 @@ actions are disallowed:
 - [Switching pricing plans](/hasura-cloud/projects/pricing.mdx)
 - [Adding, updating and deleting an environment variable](/hasura-cloud/projects/env-vars.mdx)
 - [Changing project region](/hasura-cloud/projects/regions.mdx)
-- [Enabling and disabling Heroku database URL sync](/hasura-cloud/projects/heroku-url-sync.mdx)
+- [Enabling and disabling Heroku database URL sync](/hasura-cloud/heroku-url-sync.mdx)
 - [Deleting project](/hasura-cloud/projects/delete.mdx)
 
 If you are trying to apply these changes when maintenance mode is activated, you will encounter an error.

docs/docs/hasura-cloud/projects/move-project-manual.mdx

@@ -64,13 +64,13 @@ See [deleting projects](/hasura-cloud/projects/delete.mdx) to delete the earlier
 - You can [rename](/hasura-cloud/projects/details.mdx#rename-project) your new project to the same name as the earlier
   project if you wish.
 
-- If you haven't renamed your new project or set up a [custom domain](/hasura-cloud/projects/domains.mdx) for your
+- If you haven't renamed your new project or set up a [custom domain](/hasura-cloud/domains.mdx) for your
   project, you might want to update any clients consuming the GraphQL API to point to the new project's GraphQL
   endpoint.
 
 ## Zero-downtime transfer
 
-To achieve a zero-downtime transfer, you will need to have a [custom domain](/hasura-cloud/projects/domains.mdx)
+To achieve a zero-downtime transfer, you will need to have a [custom domain](/hasura-cloud/domains.mdx)
 attached to your Cloud project. Once the new project is set up identically as the old one, you can update the DNS
 entries for your custom domain to the new project to have a seamless transfer of traffic to the new project.
 

docs/docs/hasura-cloud/regions.mdx

@@ -5,7 +5,8 @@ keywords:
   - hasura
   - cloud
   - regions
-sidebar_position: 7
+sidebar_position: 11
+sidebar_label: Supported regions
 ---
 
 import Thumbnail from '@site/src/components/Thumbnail';

docs/docs/hasura-cloud/vercel-integration.mdx

@@ -7,7 +7,7 @@ keywords:
   - docs
   - vercel
   - integration
-sidebar_position: 13
+sidebar_position: 34
 sidebar_label: Vercel integration
 ---
 
@@ -155,7 +155,7 @@ Your integration will only be successfully configured upon clicking the `Install
 
 :::info Note
 
-- If a [custom domain](/hasura-cloud/projects/domains.mdx) is added to the Hasura Cloud project, you'll have to set this
+- If a [custom domain](/hasura-cloud/domains.mdx) is added to the Hasura Cloud project, you'll have to set this
   custom value to `HASURA_PROJECT_ENDPOINT` and `NEXT_HASURA_PROJECT_ENDPOINT` manually in the respective Vercel
   project's settings.
 - Similarly if the Hasura Cloud project's admin secret is changed, you will have to edit the `HASURA_ADMIN_SECRET`

docs/docs/migrations-metadata-seeds/legacy-configs/_category_.json

@@ -1,4 +1,4 @@
 {
   "label": "Legacy Configs",
-  "position": 10
+  "position": 100
 }

docs/docs/migrations-metadata-seeds/metadata-best-practices.mdx

@@ -5,6 +5,7 @@ keywords:
   - docs
   - best practices
 sidebar_label: Metadata Best Practices
+sidebar_position: 11
 ---
 
 # Metadata Best Practices
@@ -36,7 +37,7 @@ real-world practices, user experiences, and challenges when managing enterprise-
 
 :::info Note
 
-Hasura Cloud users can leverage the [GitHub integration](/hasura-cloud/ci-cd/github-integration.mdx) to automate
+Hasura Cloud users can leverage the [GitHub integration](/cloud-ci-cd/github-integration.mdx) to automate
 deployments.
 
 :::

docs/docs/migrations-metadata-seeds/resetting-migrations-metadata.mdx

@@ -1,6 +1,6 @@
 ---
 sidebar_label: Reset Migrations and Metadata
-sidebar_position: 7
+sidebar_position: 10
 description: Reset Hasura Migrations and Metadata
 keywords:
   - hasura