Fusion upgrade guides

website/blog/2025-05-28-dbt-fusion-engine-components.md

@@ -60,7 +60,7 @@ As long as you comply with the [three restrictions in ELv2](http://www.getdbt.co
 
 Artifact type: Precompiled binary
 
-How to access: download following the instructions [here](/docs/fusion/install-fusion#install-fusion)
+How to access: download following the instructions [here](/docs/fusion/install-fusion-cli)
 
 License: ELv2
 
@@ -81,7 +81,7 @@ As long as you comply with the three restrictions in ELv2,
 
 Artifact type: Precompiled binary and managed service
 
-Available at: [Download binary](/docs/fusion/install-fusion#install-fusion) and [sign up for the service](http://getdbt.com/signup)
+Available at: [Download binary](/docs/fusion/install-fusion-cli) and [sign up for the service](http://getdbt.com/signup)
 
 License: ELv2 (binary) and Proprietary (service)
 

website/blog/2025-05-28-dbt-fusion-engine.md

@@ -18,7 +18,7 @@ is_featured: true
 - The new engine is called the dbt Fusion engine — rewritten from the ground up in Rust based on technology [from SDF](https://www.getdbt.com/blog/dbt-labs-acquires-sdf-labs).  The dbt Fusion engine is substantially faster than dbt Core and has built in [SQL comprehension technology](/blog/the-levels-of-sql-comprehension) to power the next generation of analytics engineering workflows.
 - The dbt Fusion engine is currently in beta. You can try it today if you use Snowflake — with additional adapters coming starting in early June. Review our [path to general availability](/blog/dbt-fusion-engine-path-to-ga) (GA) and [try the quickstart](/guides/fusion).
 - **You do not need to be a dbt Labs customer to use Fusion - dbt Core users can adopt the dbt Fusion engine today for free in your local environment.**
-- You can use Fusion with the [new dbt VS Code extension](https://marketplace.visualstudio.com/items?itemName=dbtLabsInc.dbt), [directly via the CLI](/docs/fusion/install-fusion), or [via dbt Studio](/docs/dbt-versions/upgrade-dbt-version-in-cloud#dbt-fusion-engine).
+- You can use Fusion with the [new dbt VS Code extension](https://marketplace.visualstudio.com/items?itemName=dbtLabsInc.dbt), [directly via the CLI](/docs/fusion/install-fusion-cli), or [via dbt Studio](/docs/dbt-versions/upgrade-dbt-version-in-cloud#dbt-fusion-engine).
 - This is the beginning of a new era for analytics engineering. For a glimpse into what the Fusion engine is going to enable over the next 1 to 2 years, [read this post](https://getdbt.com/blog/where-we-re-headed-with-the-dbt-fusion-engine).
 
 <!--truncate-->
@@ -137,7 +137,7 @@ Whether or not you can move your existing project to Fusion today, you can jump
 
 - **dbt customers:** Over the coming weeks, in projects eligible to start using Fusion, you’ll see a toggle in your account or receive a message from your account team. From there, [you can activate Fusion for your environments](/docs/dbt-versions/upgrade-dbt-version-in-cloud#dbt-fusion-engine).
 - **To use the VS Code extension:** [Install the "dbt" extension](/docs/install-dbt-extension) directly from the marketplace for automated setup and head to the quickstart. This will also automatically install the Fusion-powered CLI for you.
-- **To use the dbt CLI powered by Fusion:** Simply [install Fusion](/docs/fusion/install-fusion#install-fusion)
+- **To use the dbt CLI powered by Fusion:** Simply [install Fusion](/docs/fusion/install-fusion-cli)
 
 *If you are looking to migrate an existing project to Fusion, see the [migration guide](/docs/dbt-versions/core-upgrade/upgrading-to-fusion) — as well as the [`dbt-autofix`](https://github.com/dbt-labs/dbt-autofix) helper, which automatically addresses many of the changes needed to migrate to Fusion.*
 

website/docs/docs/configure-dbt-extension.md

@@ -1,6 +1,6 @@
 ---
-title: "Configure your local setup"
-sidebar_label: "Configure your local setup"
+title: "Configure your local environment"
+sidebar_label: "Configure your local environment"
 id: "configure-dbt-extension"
 description: "Optimize your VS Code extension environment (files, env vars, connectivity)."
 ---
@@ -216,7 +216,7 @@ To configure environment variables in the terminal session:
 
 
 
-## Configure the dbt extension
+## dbt extension settings
 <!-- moved content from website/docs/docs/fusion/install-fusion-cli.md to here -->
 
 After installing the dbt extension and configuring your local setup, you may want to configure it to better fit your development workflow:

website/docs/docs/fusion/about-fusion.md

@@ -56,7 +56,7 @@ For more information, refer to [Using threads](/docs/running-a-dbt-project/using
 You can:
 - Select Fusion from the [dropdown/toggle in the dbt platform](/docs/dbt-versions/upgrade-dbt-version-in-cloud#dbt-fusion-engine) <Lifecycle status="private_preview" />
 - [Install the dbt extension for VSCode](/docs/install-dbt-extension) <Lifecycle status="preview" />
-- [Install the Fusion CLI](/docs/fusion/install-fusion) <Lifecycle status="preview" />
+- [Install the Fusion CLI](/docs/fusion/install-fusion-cli) <Lifecycle status="preview" />
 
 
 Go straight to the [Quickstart](/guides/fusion) to _feel the Fusion_ as fast as possible.

website/docs/docs/fusion/fusion.md

@@ -47,9 +47,9 @@ Choose one of the following paths to get started with the dbt Fusion engine.
     icon="dbt-bit"/>
 
 <Card
-    title="Install Fusion"
-    body="Learn about how to install the dbt Fusion engine."
-    link="/docs/fusion/install-fusion"
+    title="Get started with Fusion"
+    body="Learn about how to start using the dbt Fusion engine."
+    link="/docs/fusion/get-started-fusion"
     icon="dbt-bit"/>
 
 <Card

website/docs/docs/fusion/get-started-fusion.md

@@ -0,0 +1,59 @@
+---
+title: "Get started with Fusion"
+description: "Start using the Fusion engine locally to take data transformation to the next level."
+id: get-started-fusion
+hide_table_of_contents: true
+hide_title: true
+---
+
+### Already using dbt? Start here
+
+Upgrade your existing projects to the <Constant name="fusion_engine" /> and learn about the tools available to you once you're there!
+
+<div className="grid--3-col">
+
+<Card
+    title="dbt VS Code extension"
+    body="Add the dbt VS Code extension to your existing development workflows for both dbt platform and the CLI."
+    link="/docs/install-dbt-extension"
+    icon="dbt-bit"/>
+
+<Card
+    title="Guide: Prepare to upgrade to Fusion"
+    body="Step-by-step guide to prepare your dbt platform projects for upgrading to Fusion."
+    link="/guides/prepare-fusion-upgrade"
+    icon="dbt-bit"/>
+
+<Card
+    title="Guide: Upgrade to Fusion"
+    body="Learn how to upgrade your eligible projects on the dbt platform to the Fusion engine with this comprehensive guide."
+    link="/guides/upgrade-to-fusion"
+    icon="dbt-bit"/>
+
+</div>
+
+### New to dbt? Start here
+
+Once you've caught up on everything [<Constant name="fusion" /> has to offer](/docs/fusion/about-fusion), begin your journey with the most powerful data transformation engine available! 
+
+<div className="grid--3-col">
+
+<Card
+    title="Install Fusion + VS Code extension"
+    body="Learn how to install and configure our most robust set of tools for local development."
+    link="/docs/fusion/install-dbt-extension"
+    icon="dbt-bit"/>
+
+<Card
+    title="Install Fusion CLI only"
+    body="Learn how to install and configure the dbt Fusion engine from your command line."
+    link="/docs/fusion/install-fusion-cli"
+    icon="dbt-bit"/>
+
+<Card
+    title="Sign up for the dbt platform"
+    body="Create a cloud-based dbt platform account to unlock the full potential of the Fusion engine."
+    link="https://www.getdbt.com/signup"
+    icon="dbt-bit"/>
+
+</div>

website/docs/docs/fusion/install-dbt-extension.md

@@ -2,7 +2,7 @@
 title: Install the dbt VS Code extension
 id: install-dbt-extension
 description: "Installation instructions for the dbt extension."
-sidebar_label: "Install the dbt extension"
+sidebar_label: "Install the VS Code extension + Fusion"
 ---
 
 # Install the dbt VS Code extension <Lifecycle status="preview" />

website/docs/docs/fusion/install-fusion-cli.md

@@ -1,5 +1,6 @@
 ---
-title: "Install Fusion from the CLI"
+title: "Install Fusion CLI"
+sidebar_label: "Install Fusion CLI only" 
 description: "Install the Fusion engine locally from the command line interface (CLI) to take data transformation to the next level."
 keywords: ["dbt Fusion engine", "Fusion", "Install Fusion", "Update Fusion", "Fusion updates" ]
 id: install-fusion-cli

website/docs/docs/install-dbt-extension.md

@@ -1,8 +1,8 @@
 ---
-title: Install the dbt VS Code extension
+title: Install and configure the dbt VS Code extension
 id: install-dbt-extension
 description: "Installation instructions for the dbt extension."
-sidebar_label: "Install the dbt extension"
+sidebar_label: "Configure the dbt extension"
 image: /img/docs/extension/extension-marketplace.png
 ---
 

website/docs/docs/introduction.md

@@ -29,7 +29,7 @@ You can learn about plans and pricing on [www.getdbt.com](https://www.getdbt.com
 
 The <Constant name="fusion_engine" /> is the next-generation dbt engine, designed to deliver data teams a lightning-fast development experience, intelligent cost savings, and improved governance.
 
-For more information, refer to [the <Constant name="fusion_engine" />](/docs/fusion), [supported features](/docs/fusion/supported-features), and the [installation instructions](/docs/fusion/install-fusion) pages.
+For more information, refer to [the <Constant name="fusion_engine" />](/docs/fusion), [supported features](/docs/fusion/supported-features), and the [installation instructions](/docs/fusion/get-started-fusion) pages.
 
 ### dbt Core
 

website/docs/guides/_config.md

@@ -2,6 +2,12 @@
 title: Browse our guides
 description: The dbt platform is the fastest and most reliable way to deploy dbt for scalable data transformation, while dbt Core powers open-source transformation workflows. Together, they provide a seamless analytics engineering experience. Explore our step-by-step guides, quickstart tutorials, and troubleshooting resources to get started with dbt and your data platform.
 categories:
+  - title: Fusion
+    guides:
+      - fusion
+      - prepare-fusion-upgrade
+      - upgrade-to-fusion
+
   - title: Most popular
     guides:
       - fusion

website/docs/guides/fusion-qs.md

@@ -32,7 +32,7 @@ This quickstart guide will get you from zero to running your first dbt project w
 | Environment | How to use <Constant name="fusion" /> |
 |--------------|-------------------|
 | **<Constant name="cloud_ide" />** | <Constant name="fusion" /> is automatically enabled; just [upgrade your environment(s)](/docs/dbt-versions/upgrade-dbt-version-in-cloud#dbt-fusion-engine). |
-| **dbt CLI (local)** | [Install <Constant name="fusion_engine" />](/docs/fusion/install-fusion) locally following this guide. |
+| **dbt CLI (local)** | [Install <Constant name="fusion_engine" />](/docs/fusion/install-fusion-cli) locally following this guide. |
 | **VS Code / Cursor IDE** | [Install the dbt extension](/docs/install-dbt-extension) to unlock <Constant name="fusion" />'s interactive power in your editor. |
 
 To learn more about which tool is best for you, see the [Fusion availability](/docs/fusion/fusion-availability) page. To learn about the <Constant name="fusion_engine" /> and how it works, read more [about the dbt Fusion engine](/docs/fusion/about-fusion).
@@ -68,7 +68,7 @@ It's easy to think of the <Constant name="fusion_engine" /> and the dbt extensio
 - You *cannot* use the dbt extension without <Constant name="fusion" /> installed.
 :::
 
-The following are the essential steps from the [<Constant name="fusion_engine" />](/docs/fusion/install-fusion) and [extension](/docs/install-dbt-extension) installation guides:
+The following are the essential steps from the [<Constant name="fusion_engine" />](/docs/fusion/install-fusion-cli) and [extension](/docs/install-dbt-extension) installation guides:
 
 <Tabs queryString="installation">
 <TabItem value="mac-linux" label="macOS & Linux">