[DRAFT] Migration guide move to docs

dbt-labs · Oct 30, 2023 · e343573 · e343573
1 parent 35a5949
commit e343573
Show file tree

Hide file tree

Showing 23 changed files with 113 additions and 17 deletions.
diff --git a/...igration/versions/00-upgrading-to-v1.7.md → ...ions/core-upgrade/00-upgrading-to-v1.7.md b/...igration/versions/00-upgrading-to-v1.7.md → ...ions/core-upgrade/00-upgrading-to-v1.7.md
@@ -3,6 +3,10 @@ title: "Upgrading to v1.7 (beta)"
 description: New features and changes in dbt Core v1.7
 ---
 
+import UpgradeMove from '/snippets/_upgrade-move.md';
+
+<UpgradeMove />
+
 ## Resources
 
 - [Changelog](https://github.com/dbt-labs/dbt-core/blob/8aaed0e29f9560bc53d9d3e88325a9597318e375/CHANGELOG.md)

diff --git a/...igration/versions/01-upgrading-to-v1.6.md → ...ions/core-upgrade/01-upgrading-to-v1.6.md b/...igration/versions/01-upgrading-to-v1.6.md → ...ions/core-upgrade/01-upgrading-to-v1.6.md
@@ -3,6 +3,10 @@ title: "Upgrading to v1.6 (latest)"
 description: New features and changes in dbt Core v1.6
 ---
 
+import UpgradeMove from '/snippets/_upgrade-move.md';
+
+<UpgradeMove />
+
 dbt Core v1.6 has three significant areas of focus:
 1. Next milestone of [multi-project deployments](https://github.com/dbt-labs/dbt-core/discussions/6725): improvements to contracts, groups/access, versions; and building blocks for cross-project `ref`
 1. Semantic layer re-launch: dbt Core and [MetricFlow](https://docs.getdbt.com/docs/build/about-metricflow) integration

diff --git a/...igration/versions/02-upgrading-to-v1.5.md → ...ions/core-upgrade/02-upgrading-to-v1.5.md b/...igration/versions/02-upgrading-to-v1.5.md → ...ions/core-upgrade/02-upgrading-to-v1.5.md
@@ -3,6 +3,10 @@ title: "Upgrading to v1.5"
 description: New features and changes in dbt Core v1.5
 ---
 
+import UpgradeMove from '/snippets/_upgrade-move.md';
+
+<UpgradeMove />
+
 dbt Core v1.5 is a feature release, with two significant additions:
 1. [**Model governance**](/docs/collaborate/govern/about-model-governance) — access, contracts, versions — the first phase of [multi-project deployments](https://github.com/dbt-labs/dbt-core/discussions/6725)
 2. A Python entry point for [**programmatic invocations**](/reference/programmatic-invocations), at parity with the CLI

diff --git a/...ersions/03-upgrading-to-dbt-utils-v1.0.md → ...upgrade/03-upgrading-to-dbt-utils-v1.0.md b/...ersions/03-upgrading-to-dbt-utils-v1.0.md → ...upgrade/03-upgrading-to-dbt-utils-v1.0.md
@@ -3,6 +3,10 @@ title: "Upgrading to dbt utils v1.0"
 description: New features and breaking changes to consider as you upgrade to dbt utils v1.0.
 ---
 
+import UpgradeMove from '/snippets/_upgrade-move.md';
+
+<UpgradeMove />
+
 # Upgrading to dbt utils v1.0
 
 For the first time, [dbt utils](https://hub.getdbt.com/dbt-labs/dbt_utils/latest/) is crossing the major version boundary. From [last month’s blog post](https://www.getdbt.com/blog/announcing-dbt-v1.3-and-utils/): 

diff --git a/...igration/versions/04-upgrading-to-v1.4.md → ...ions/core-upgrade/04-upgrading-to-v1.4.md b/...igration/versions/04-upgrading-to-v1.4.md → ...ions/core-upgrade/04-upgrading-to-v1.4.md
@@ -2,6 +2,11 @@
 title: "Upgrading to v1.4"
 description: New features and changes in dbt Core v1.4
 ---
+
+import UpgradeMove from '/snippets/_upgrade-move.md';
+
+<UpgradeMove />
+
 ### Resources
 
 - [Changelog](https://github.com/dbt-labs/dbt-core/blob/1.4.latest/CHANGELOG.md)

diff --git a/...igration/versions/05-upgrading-to-v1.3.md → ...ions/core-upgrade/05-upgrading-to-v1.3.md b/...igration/versions/05-upgrading-to-v1.3.md → ...ions/core-upgrade/05-upgrading-to-v1.3.md
@@ -2,6 +2,11 @@
 title: "Upgrading to v1.3"
 description: New features and changes in dbt Core v1.3
 ---
+
+import UpgradeMove from '/snippets/_upgrade-move.md';
+
+<UpgradeMove />
+
 ### Resources
 
 - [Changelog](https://github.com/dbt-labs/dbt-core/blob/1.3.latest/CHANGELOG.md)

diff --git a/...igration/versions/06-upgrading-to-v1.2.md → ...ions/core-upgrade/06-upgrading-to-v1.2.md b/...igration/versions/06-upgrading-to-v1.2.md → ...ions/core-upgrade/06-upgrading-to-v1.2.md
@@ -2,6 +2,11 @@
 title: "Upgrading to v1.2"
 description: New features and changes in dbt Core v1.2
 ---
+
+import UpgradeMove from '/snippets/_upgrade-move.md';
+
+<UpgradeMove />
+
 ### Resources
 
 - [Changelog](https://github.com/dbt-labs/dbt-core/blob/1.2.latest/CHANGELOG.md)

diff --git a/...igration/versions/07-upgrading-to-v1.1.md → ...ions/core-upgrade/07-upgrading-to-v1.1.md b/...igration/versions/07-upgrading-to-v1.1.md → ...ions/core-upgrade/07-upgrading-to-v1.1.md
@@ -2,6 +2,11 @@
 title: "Upgrading to v1.1"
 description: New features and changes in dbt Core v1.1
 ---
+
+import UpgradeMove from '/snippets/_upgrade-move.md';
+
+<UpgradeMove />
+
 ### Resources
 
 - [Changelog](https://github.com/dbt-labs/dbt-core/blob/1.1.latest/CHANGELOG.md)

diff --git a/...igration/versions/08-upgrading-to-v1.0.md → ...ions/core-upgrade/08-upgrading-to-v1.0.md b/...igration/versions/08-upgrading-to-v1.0.md → ...ions/core-upgrade/08-upgrading-to-v1.0.md
@@ -2,6 +2,11 @@
 title: "Upgrading to v1.0"
 description: New features and changes in dbt Core v1.0
 ---
+
+import UpgradeMove from '/snippets/_upgrade-move.md';
+
+<UpgradeMove />
+
 ### Resources
 
 - [Discourse](https://discourse.getdbt.com/t/3180)

diff --git a/...gration/versions/09-upgrading-to-v0.21.md → ...ons/core-upgrade/09-upgrading-to-v0.21.md b/...gration/versions/09-upgrading-to-v0.21.md → ...ons/core-upgrade/09-upgrading-to-v0.21.md
@@ -3,6 +3,11 @@ title: "Upgrading to v0.21"
 
 ---
 
+import UpgradeMove from '/snippets/_upgrade-move.md';
+
+<UpgradeMove />
+
+
 :::caution Unsupported version
 dbt Core v0.21 has reached the end of critical support. No new patch versions will be released, and it will stop running in dbt Cloud on June 30, 2022. Read ["About dbt Core versions"](/docs/dbt-versions/core) for more details.
 :::

diff --git a/...gration/versions/10-upgrading-to-v0.20.md → ...ons/core-upgrade/10-upgrading-to-v0.20.md b/...gration/versions/10-upgrading-to-v0.20.md → ...ons/core-upgrade/10-upgrading-to-v0.20.md
@@ -3,6 +3,10 @@ title: "Upgrading to v0.20"
 
 ---
 
+import UpgradeMove from '/snippets/_upgrade-move.md';
+
+<UpgradeMove />
+
 :::caution Unsupported version
 dbt Core v0.20 has reached the end of critical support. No new patch versions will be released, and it will stop running in dbt Cloud on June 30, 2022. Read ["About dbt Core versions"](/docs/dbt-versions/core) for more details.
 :::

diff --git a/.../11-Older versions/upgrading-to-0-11-0.md → .../11-Older versions/upgrading-to-0-11-0.md b/.../11-Older versions/upgrading-to-0-11-0.md → .../11-Older versions/upgrading-to-0-11-0.md
@@ -3,6 +3,10 @@ title: "Upgrading to 0.11.0"
 id: "upgrading-to-0-11-0"
 ---
 
+import UpgradeMove from '/snippets/_upgrade-move.md';
+
+<UpgradeMove />
+
 ## Schema.yml v2 syntax
 dbt v0.11.0 adds an auto-generated docs site to your dbt project. To make effective use of the documentation site, you'll need to use the new "version 2" schema.yml syntax. For a full explanation of the version 2 syntax, check out the [schema.yml Files](/reference/configs-and-properties) section of the documentation.
 

diff --git a/.../11-Older versions/upgrading-to-0-12-0.md → .../11-Older versions/upgrading-to-0-12-0.md b/.../11-Older versions/upgrading-to-0-12-0.md → .../11-Older versions/upgrading-to-0-12-0.md
@@ -3,6 +3,10 @@ title: "Upgrading to 0.12.0"
 id: "upgrading-to-0-12-0"
 ---
 
+import UpgradeMove from '/snippets/_upgrade-move.md';
+
+<UpgradeMove />
+
 ## End of support
 
 Support for the `repositories:` block in `dbt_project.yml` (deprecated in 0.10.0) was removed.

diff --git a/.../11-Older versions/upgrading-to-0-13-0.md → .../11-Older versions/upgrading-to-0-13-0.md b/.../11-Older versions/upgrading-to-0-13-0.md → .../11-Older versions/upgrading-to-0-13-0.md
@@ -3,6 +3,10 @@ title: "Upgrading to 0.13.0"
 id: "upgrading-to-0-13-0"
 ---
 
+import UpgradeMove from '/snippets/_upgrade-move.md';
+
+<UpgradeMove />
+
 ## Breaking changes
 
 ### on-run-start and on-run-end

diff --git a/.../11-Older versions/upgrading-to-0-14-0.md → .../11-Older versions/upgrading-to-0-14-0.md b/.../11-Older versions/upgrading-to-0-14-0.md → .../11-Older versions/upgrading-to-0-14-0.md
@@ -3,6 +3,10 @@ title: "Upgrading to 0.14.0"
 id: "upgrading-to-0-14-0"
 ---
 
+import UpgradeMove from '/snippets/_upgrade-move.md';
+
+<UpgradeMove />
+
 This guide outlines migration instructions for:
 
 1. [Upgrading archives to snapshots](#upgrading-to-snapshot-blocks)

diff --git a/.../11-Older versions/upgrading-to-0-14-1.md → .../11-Older versions/upgrading-to-0-14-1.md b/.../11-Older versions/upgrading-to-0-14-1.md → .../11-Older versions/upgrading-to-0-14-1.md
@@ -3,6 +3,10 @@ title: "Upgrading to 0.14.1"
 id: "upgrading-to-0-14-1"
 ---
 
+import UpgradeMove from '/snippets/_upgrade-move.md';
+
+<UpgradeMove />
+
 The dbt v0.14.1 release _does not_ contain any breaking code changes for users upgrading from v0.14.0. If you are upgrading from a version less than 0.14.0, consult the [Upgrading to 0.14.0](upgrading-to-0-14-0) migration guide. The following section contains important information for users of the `check` strategy on Snowflake and BigQuery. Action may be required in your database.
 
 ## Changes to the Snapshot "check" algorithm

diff --git a/.../11-Older versions/upgrading-to-0-15-0.md → .../11-Older versions/upgrading-to-0-15-0.md b/.../11-Older versions/upgrading-to-0-15-0.md → .../11-Older versions/upgrading-to-0-15-0.md
@@ -3,8 +3,13 @@ title: "Upgrading to 0.15.0"
 id: "upgrading-to-0-15-0"
 ---
 
+import UpgradeMove from '/snippets/_upgrade-move.md';
+
+<UpgradeMove />
+
 The dbt v0.15.0 release contains a handful of breaking code changes for users upgrading from v0.14.0.
 
+
 ## Breaking changes
 
 ### Stricter YML compilation

diff --git a/.../11-Older versions/upgrading-to-0-16-0.md → .../11-Older versions/upgrading-to-0-16-0.md b/.../11-Older versions/upgrading-to-0-16-0.md → .../11-Older versions/upgrading-to-0-16-0.md
@@ -3,6 +3,10 @@ title: "Upgrading to 0.16.0"
 id: "upgrading-to-0-16-0"
 ---
 
+import UpgradeMove from '/snippets/_upgrade-move.md';
+
+<UpgradeMove />
+
 dbt v0.16.0 contains many new features, bug fixes, and improvements. This guide
 covers all of the important information to consider when upgrading from an earlier
 version of dbt to 0.16.0.

diff --git a/.../11-Older versions/upgrading-to-0-17-0.md → .../11-Older versions/upgrading-to-0-17-0.md b/.../11-Older versions/upgrading-to-0-17-0.md → .../11-Older versions/upgrading-to-0-17-0.md
@@ -4,6 +4,10 @@ id: "upgrading-to-0-17-0"
 
 ---
 
+import UpgradeMove from '/snippets/_upgrade-move.md';
+
+<UpgradeMove />
+
 dbt v0.17.0 makes compilation more consistent, improves performance, and fixes a number of bugs.
 
 ## Articles:

diff --git a/.../11-Older versions/upgrading-to-0-18-0.md → .../11-Older versions/upgrading-to-0-18-0.md b/.../11-Older versions/upgrading-to-0-18-0.md → .../11-Older versions/upgrading-to-0-18-0.md
@@ -3,6 +3,10 @@ title: "Upgrading to 0.18.0"
 
 ---
 
+import UpgradeMove from '/snippets/_upgrade-move.md';
+
+<UpgradeMove />
+
 ### Resources
 
 - [Changelog](https://github.com/dbt-labs/dbt-core/blob/dev/marian-anderson/CHANGELOG.md)

diff --git a/.../11-Older versions/upgrading-to-0-19-0.md → .../11-Older versions/upgrading-to-0-19-0.md b/.../11-Older versions/upgrading-to-0-19-0.md → .../11-Older versions/upgrading-to-0-19-0.md
@@ -3,6 +3,10 @@ title: "Upgrading to 0.19.0"
 
 ---
 
+import UpgradeMove from '/snippets/_upgrade-move.md';
+
+<UpgradeMove />
+
 ### Resources
 
 - [Discourse](https://discourse.getdbt.com/t/1951)

diff --git a/website/sidebars.js b/website/sidebars.js
@@ -599,6 +599,23 @@ const sidebarSettings = {
         "docs/dbt-versions/upgrade-core-in-cloud",
         "docs/dbt-versions/product-lifecycles",
         "docs/dbt-versions/experimental-features",
+        {
+          type: "category",
+          label: "dbt Core upgrade guides",
+          link: {
+            type: "generated-index",
+            title: "Version upgrade guides",
+            description:
+              "Learn what's new in the latest version of dbt Core.",
+            slug: "/docs/dbt-versions/core-upgrade",
+          },
+          items: [
+            {
+              type: "autogenerated",
+              dirName: "docs/dbt-versions/core-upgrade",
+            },
+          ],
+        },
         {
           type: "category",
           label: "dbt Cloud Release Notes",
@@ -1106,23 +1123,6 @@ const sidebarSettings = {
       label: "Migration",
       items: [
         "guides/migration/sl-migration",
-        {
-          type: "category",
-          label: "Versions",
-          link: {
-            type: "generated-index",
-            title: "Version migration guides",
-            description:
-              "Learn how to upgrade to the latest version of dbt Core.",
-            slug: "/guides/migration/versions",
-          },
-          items: [
-            {
-              type: "autogenerated",
-              dirName: "guides/migration/versions",
-            },
-          ],
-        },
         {
           type: "category",
           label: "Tools",

diff --git a/website/snippets/_upgrade-move.md b/website/snippets/_upgrade-move.md
@@ -0,0 +1,5 @@
+:::important Upgrade Guides Are Moving
+
+The location of the dbt Core upgrade guides has changed, and they will soon be removed from `Guides`. The new location is in the `Docs` tab under `Available dbt versions`. You have been redirected to the new URL, so please update any saved links and bookmarks.
+
+:::