dbt-labs · mirnawong1 · Oct 13, 2023 · Oct 3, 2023 · Oct 3, 2023 · Oct 3, 2023
diff --git a/website/docs/docs/cloud/about-cloud-develop.md b/website/docs/docs/cloud/about-cloud-develop.md
@@ -0,0 +1,20 @@
+---
+title: About developing in dbt Cloud
+id: about-cloud-develop
+description: "Learn how to develop your dbt projects using dbt Cloud."
+sidebar_label: "About developing in dbt Cloud"
+pagination_next: "docs/cloud/cloud-cli-installation"
+---
+
+dbt Cloud offers a fast and reliable way to work on your dbt project. You can use it through an integrated development environment (IDE) in your browser or a dbt Cloud-powered command line interface (CLI):
+
+- **[dbt Cloud CLI](/docs/cloud/cloud-cli-installation)** &mdash; Allows you to develop and run dbt commands from your local command line or code editor against your dbt Cloud development environment.
+
+  - Something to note is that the dbt Cloud CLI and the open-sourced dbt Core are both command line tools that let you run your dbt projects and use the same dbt commands. The key difference is that the dbt Cloud CLI is designed to work specifically with dbt Cloud's infrastructure and integrates those builds with all [dbt Cloud features](/docs/cloud/about-cloud/dbt-cloud-features).
+
+- **[dbt Cloud IDE](/docs/cloud/dbt-cloud-ide/develop-in-the-cloud)** &mdash; Develop directly in your browser, making dbt project development efficient by compiling code into SQL and managing project changes seamlessly using an intuitive user interface (UI).
+
+This documentation section provides detailed instructions on setting up the dbt Cloud CLI and dbt Cloud IDE. To get started with dbt development, you'll need a [developer](/docs/cloud/manage-access/seats-and-users) account. For a more comprehensive setup guide, refer to our [quickstart guides](/quickstarts).
+
+
+
diff --git a/website/docs/docs/cloud/cloud-cli-installation.md b/website/docs/docs/cloud/cloud-cli-installation.md
@@ -1,14 +1,13 @@
 ---
-title: Installing the dbt Cloud CLI (Alpha)
+title: Install dbt Cloud CLI 
 id: cloud-cli-installation
 description: "Instructions for installing and configuring dbt Cloud CLI"
+pagination_next: "docs/cloud/configure-cloud-cli"
 ---
 
-:::warning Alpha functionality 
+:::info Public preview functionality
 
-The following installation instructions are for the dbt Cloud CLI, currently in Alpha (actively in development and being tested). 
-
-These instructions are not intended for general audiences at this time. 
+The dbt Cloud CLI is currently in [public preview](/docs/dbt-versions/product-lifecycles#dbt-cloud). Share feedback or request features you'd like to see on the [dbt community Slack](https://getdbt.slack.com/archives/C05M77P54FL).
 
 ::: 
 
@@ -34,6 +33,7 @@ You can install the dbt Cloud CLI on the command line by using one of these meth
 
 Before you begin, make sure you have [Homebrew installed](http://brew.sh/) in your code editor or command line terminal. If your operating system runs into path conflicts, refer to the [FAQs](#faqs).
 
+
 1. Run the following command to verify that there is no conflict with a dbt Core installation on your system:
 
 ```bash
@@ -49,8 +49,7 @@ brew install dbt-cloud-cli
 ```
 
 3. Verify the installation by running `dbt --help` from the command line. If the help text doesn't indicate that you're using the dbt Cloud CLI, make sure you've deactivated your pyenv or venv and don't have a version of dbt globally installed.
-
-* You no longer need to use the `dbt deps` command. Previously, you had to run that command.
+  * You no longer need to use the `dbt deps` command. Previously, you had to run that command.
 
 </TabItem>
 
@@ -70,8 +69,7 @@ Note that if you are using VS Code, you'll need to restart it to pick up modifie
 :::
 
 3. Verify the installation by running `./dbt --help` from the command line. If the help text doesn't indicate that you're using the dbt Cloud CLI, make sure you've deactivated your pyenv or venv and don't have a version of dbt globally installed.
-
-* You no longer need to use the `dbt deps` command. Previously, you had to run that command.
+  * You no longer need to use the `dbt deps` command. Previously, you had to run that command.
 
 </TabItem>
 
@@ -95,16 +93,16 @@ Advanced users can configure multiple projects to use the same Cloud CLI executa
 :::
 
 3. Verify the installation by running `./dbt --help` from the command line. If the help text doesn't indicate that you're using the dbt Cloud CLI, make sure you've deactivated your pyenv or venv and don't have a version of dbt globally installed.
-
-* You no longer need to use the `dbt deps` command. Previously, you had to run that command.
+  * You no longer need to use the `dbt deps` command. Previously, you had to run that command.
 
 </TabItem>
 
 </Tabs>
 
 ## Update dbt Cloud CLI
 
-The following instructions explain how to update the dbt CLoud CLI to the latest version depending on your operating system. 
+The following instructions explain how to update the dbt CLoud CLI to the latest version depending on your operating system. During the public preview period, we recommend updating before filing a bug report. This is because the API is subject to breaking changes.
+
 
 <Tabs>
 
@@ -121,65 +119,16 @@ To update, follow the same process explained in [Install manually (Windows)](/do
 
 </Tabs>
 
-## Configure the dbt Cloud CLI
-
-After installation, you can configure the dbt Cloud CLI for your dbt Cloud project and use it to run [dbt commands](/reference/dbt-commands) similar to dbt Core. For example, you can execute the following command to compile a project using dbt Cloud:
-
-```bash
-dbt compile
-```
-
-**Prerequisites**
-
-- You must set up a project in dbt Cloud.
-- You must have your [personal development credentials](/docs/dbt-cloud-environments#set-developer-credentials) set for that project. The dbt Cloud CLI will use these credentials, stored securely in dbt Cloud, to communicate with your data platform.
-- You must [enroll](/docs/dbt-versions/experimental-features) in the dbt Cloud beta features. 
-	- To enroll, navigate to your **Profile Settings** and enable the **Beta** flag under **Experimental Features**.
-
-Once you install the dbt Cloud CLI, you need to configure it to connect to a dbt Cloud project.
-
-1. Ensure you meet the prerequisites above.
-2. Create an environment variable with your [dbt Cloud API key](/docs/dbt-cloud-apis/user-tokens):
-   - On MacOS, Linux, or Windows add an environment variable:
 
-        ```bash
-        export DBT_CLOUD_API_KEY="1234" # Replace 1234 with your API key   
-        ```
+## Next steps
 
-   - In Powershell, add an environment variable: 
-     - Note that this variable resets if you restart your shell. To add an environment variable permanently, add a system environment variable in your platform.
+After installation, you can [configure](/docs/cloud/configure-cloud-cli) the dbt Cloud CLI for your dbt Cloud project and use it to run [dbt commands](/reference/dbt-commands) similar to dbt Core. For example, you can execute the following commands to compile a project using dbt Cloud:
 
-3. Navigate to a dbt project in your terminal:
 
 ```bash
-cd ~/dbt-projects/jaffle_shop
-```
-
-4. In your `dbt_project.yml` file, ensure there is a section titled `dbt-cloud`. This section is required to have a `project-id` field with a valid project ID. 
-
-```yaml
-# dbt_project.yml
-name:
-
-version:
-...
-
-dbt-cloud: 
-    project-id: PROJECT_ID
+dbt compile
 ```
 
-- To find your project ID, go to **Develop** in the navigation menu. Select the dbt Cloud project URL, such as `https://cloud.getdbt.com/develop/26228/projects123456`, where the project ID is `123456`.
-
-
-## Use the dbt Cloud CLI
-
-The dbt Cloud CLI shares the same set of commands as dbt Core. When you invoke a dbt command, that command is sent to dbt Cloud for processing. 
-
-The dbt Cloud CLI supports [project dependencies](/docs/collaborate/govern/project-dependencies), which is an exciting way to depend on another project using the metadata service in dbt Cloud. It instantly resolves references (or  `ref`) to public models defined in other projects. You don't need to execute or analyze these upstream models yourself. Instead, you treat them as an API that returns a dataset.
-
-Share feedback or request features you'd like to see on the [dbt community Slack](https://getdbt.slack.com/archives/C05M77P54FL).
-
-
 ## FAQs
 
 <details>
@@ -198,3 +147,4 @@ If you have dbt Core installed locally, ensure that you deactivate your Python e
 You can always uninstall the Cloud CLI to return to using dbt Core.
 </details>
 
+
diff --git a/website/docs/docs/cloud/configure-cloud-cli.md b/website/docs/docs/cloud/configure-cloud-cli.md
@@ -0,0 +1,65 @@
+---
+title: Configure dbt Cloud CLI
+id: configure-cloud-cli
+description: "Instructions on how to configure the dbt Cloud CLI"
+---
+
+:::info Public preview functionality
+
+The dbt Cloud CLI is currently in [public preview](/docs/dbt-versions/product-lifecycles#dbt-cloud). Share feedback or request features you'd like to see on the [dbt community Slack](https://getdbt.slack.com/archives/C05M77P54FL).
+
+::: 
+
+
+## Prerequisites
+
+- You must set up a project in dbt Cloud.
+- You must have your [personal development credentials](/docs/dbt-cloud-environments#set-developer-credentials) set for that project. The dbt Cloud CLI will use these credentials, stored securely in dbt Cloud, to communicate with your data platform.
+- You must [enroll](/docs/dbt-versions/experimental-features) in the dbt Cloud beta features. 
+	- To enroll, navigate to your **Profile Settings** and enable the **Beta** flag under **Experimental Features**.
+
+
+## Configure the dbt Cloud CLI
+
+Once you install the dbt Cloud CLI, you need to configure it to connect to a dbt Cloud project.
+
+1. Ensure you meet the prerequisites above.
+2. Create an environment variable with your [dbt Cloud API key](/docs/dbt-cloud-apis/user-tokens):
+   - On MacOS, Linux, or Windows add an environment variable:
+
+        ```bash
+        export DBT_CLOUD_API_KEY="1234" # Replace 1234 with your API key   
+        ```
+
+   - In Powershell, add an environment variable: IS THIS MISSING SOMETHING?
+     - Note that this variable resets if you restart your shell. To add an environment variable permanently, add a system environment variable in your platform.
+
+3. Navigate to a dbt project in your terminal:
+
+```bash
+cd ~/dbt-projects/jaffle_shop
+```
+
+4. In your `dbt_project.yml` file, ensure there is a section titled `dbt-cloud`. This section is required to have a `project-id` field with a valid project ID. 
+
+```yaml
+# dbt_project.yml
+name:
+
+version:
+...
+
+dbt-cloud: 
+    project-id: PROJECT_ID
+```
+
+- To find your project ID, go to **Develop** in the navigation menu. Select the dbt Cloud project URL, such as `https://cloud.getdbt.com/develop/26228/projects123456`, where the project ID is `123456`.
+
+
+## Use the dbt Cloud CLI
+
+The dbt Cloud CLI shares the same set of commands as dbt Core. When you invoke a dbt command, that command is sent to dbt Cloud for processing. 
+
+The dbt Cloud CLI supports [project dependencies](/docs/collaborate/govern/project-dependencies), which is an exciting way to depend on another project using the metadata service in dbt Cloud. It instantly resolves references (or  `ref`) to public models defined in other projects. You don't need to execute or analyze these upstream models yourself. Instead, you treat them as an API that returns a dataset.
+
+Share feedback or request features you'd like to see on the [dbt community Slack](https://getdbt.slack.com/archives/C05M77P54FL).
diff --git a/website/docs/docs/cloud/dbt-cloud-ide/develop-in-the-cloud.md b/website/docs/docs/cloud/dbt-cloud-ide/develop-in-the-cloud.md
@@ -1,17 +1,16 @@
 ---
-title: "Develop in the IDE"
+title: "About the dbt Cloud IDE"
 id: develop-in-the-cloud
 description: "Develop, test, run, and build in the Cloud IDE. With the Cloud IDE, you can compile dbt code into SQL and run it against your database directly"
-sidebar_label: Develop in the IDE
+sidebar_label: About the IDE
 tags: [IDE]
+pagination_next: "docs/cloud/dbt-cloud-ide/ide-user-interface"
 ---
 
 The dbt Cloud integrated development environment (IDE) is a single interface for building, testing, running, and version-controlling dbt projects from your browser. With the Cloud IDE, you can compile dbt code into SQL and run it against your database directly. 
 
 ## Prerequisites
 
-To develop in the Cloud IDE, make sure you have the following:
-
 - A [dbt Cloud account](https://cloud.getdbt.com/) and [Developer seat license](/docs/cloud/manage-access/seats-and-users)
 - A git repository set up and git provider must have `write` access enabled. See [Connecting your GitHub Account](/docs/cloud/git/connect-github) or [Importing a project by git URL](/docs/cloud/git/import-a-project-by-git-url) for detailed setup instructions
 - A dbt project connected to a [data platform](/docs/cloud/connect-data-platform/about-connections)
@@ -24,9 +23,9 @@ To improve your experience using dbt Cloud, we suggest that you turn off ad bloc
 
 :::
 
-## Develop in the Cloud IDE
+## Develop in the dbt Cloud IDE
 
-The Cloud IDE is a powerful tool that can help streamline and govern your data platform development process. It offers a range of [editing features](/docs/cloud/dbt-cloud-ide/ide-user-interface#editing-features) that can help make your data platform development process faster and more efficient. Some of the editing features include:
+The dbt Cloud IDE is a powerful tool that can help streamline and govern your data platform development process. It offers a range of [editing features](/docs/cloud/dbt-cloud-ide/ide-user-interface#editing-features) that can help make your data platform development process faster and more efficient. Some of the editing features include:
 
 - The IDE has syntax highlighting for SQL. This makes it easy to visually distinguish between different parts of your code. This helps prevent syntax errors and improve readability.
 - Use the IDE built-in auto-completion, which suggests table names, arguments, and column names as you type. This saves time and reduces the likelihood of typos or errors in your code.
@@ -38,7 +37,7 @@ All of these [features](#cloud-ide-features) work together to create a powerful
 
 <Lightbox src="/img/docs/dbt-cloud/cloud-ide/ide-basic-layout.jpg" width="85%" title="The Cloud IDE layout includes version control on the upper left, files/folders on the left, editor on the right, and command/console at the bottom"/>
 
-## Cloud IDE features
+## dbt Cloud IDE features
 
 The dbt Cloud IDE comes with [tips](/docs/cloud/dbt-cloud-ide/dbt-cloud-tips) and [features](/docs/cloud/dbt-cloud-ide/ide-user-interface) that make it easier for you to develop, build, compile, run, and test data models. 
 

diff --git a/website/sidebars.js b/website/sidebars.js
@@ -117,26 +117,40 @@ const sidebarSettings = {
             }, // Supported Git providers
             {
               type: "category",
-              label: "Develop in the IDE",
-              link: {
-                type: "doc",
-                id: "docs/cloud/dbt-cloud-ide/develop-in-the-cloud",
-              },
+              label: "Develop in dbt Cloud",
+              link: { type: "doc", id: "docs/cloud/about-cloud-develop" },
               items: [
-                "docs/cloud/dbt-cloud-ide/ide-user-interface",
-                "docs/cloud/dbt-cloud-ide/lint-format",
-                "docs/cloud/dbt-cloud-ide/dbt-cloud-tips",
+                "docs/cloud/about-cloud-develop",
+                {
+                  type: "category",
+                  label: "dbt Cloud CLI (public preview)",
+                  link: { type: "doc", id: "docs/cloud/cloud-cli-installation" },
+                  items: [
+                    "docs/cloud/cloud-cli-installation",
+                    "docs/cloud/configure-cloud-cli",
+                  ],
+                },
+                {
+                  type: "category",
+                  label: "dbt Cloud IDE",
+                  link: { type: "doc", id: "docs/cloud/dbt-cloud-ide/develop-in-the-cloud" },
+                  items: [
+                    "docs/cloud/dbt-cloud-ide/develop-in-the-cloud",
+                    "docs/cloud/dbt-cloud-ide/ide-user-interface",
+                    "docs/cloud/dbt-cloud-ide/lint-format",
+                    "docs/cloud/dbt-cloud-ide/dbt-cloud-tips",
+                  ],
+                },
               ],
-            }, // dbt Cloud IDE directory
+            }, // dbt Cloud develop directory
             {
               type: "category",
               label: "Secure your tenant",
               items: [
                 "docs/cloud/secure/about-privatelink",
                 "docs/cloud/secure/snowflake-privatelink",
-                "docs/cloud/secure/databricks-privatelink",
                 "docs/cloud/secure/redshift-privatelink",
-                "docs/cloud/secure/postgres-privatelink",
+                "docs/cloud/secure/databricks-privatelink",
                 "docs/cloud/secure/ip-restrictions",
               ],
             }, // PrivateLink
@@ -525,7 +539,6 @@ const sidebarSettings = {
           link: { type: "doc", id: "docs/dbt-cloud-apis/sl-api-overview" },
           items: [
             "docs/dbt-cloud-apis/sl-jdbc",
-            "docs/dbt-cloud-apis/sl-graphql",
             "docs/dbt-cloud-apis/sl-manifest",
           ],
         },
@@ -1213,7 +1226,6 @@ const sidebarSettings = {
         "community/resources/oss-expectations",
         "community/resources/oss-projects",
         "community/resources/contributor-license-agreements",
-        "community/resources/jobs-terms-and-conditions",
         "community/resources/speaking-at-a-meetup",
       ],
     },