From 1b148d59af5b08f98e8f5e020fdc6fca29ea9d7b Mon Sep 17 00:00:00 2001
From: "Leona B. Campbell" <3880403+runleonarun@users.noreply.github.com>
Date: Mon, 6 Nov 2023 17:54:43 -0800
Subject: [PATCH] adding feedback from @nghi-ly

---
 website/docs/guides/airflow-and-dbt-cloud.md                 | 4 +++-
 website/docs/guides/bigquery-qs.md                           | 3 +--
 website/docs/guides/building-packages.md                     | 4 ++--
 website/docs/guides/codespace-qs.md                          | 3 ++-
 website/docs/guides/creating-new-materializations.md         | 5 ++---
 website/docs/guides/custom-cicd-pipelines.md                 | 4 ----
 website/docs/guides/databricks-qs.md                         | 3 ++-
 ...t models on Databricks.md => dbt-models-on-databricks.md} | 1 +
 website/docs/guides/debugging-schema-names.md                | 2 +-
 .../docs/guides/how-to-set-up-your-databricks-dbt-project.md | 3 +++
 .../how-to-use-databricks-workflows-to-run-dbt-cloud-jobs.md | 1 +
 website/docs/guides/manual-install-qs.md                     | 2 ++
 website/docs/guides/migrating-from-spark-to-databricks.md    | 1 -
 website/docs/guides/redshift-qs.md                           | 3 +--
 website/docs/guides/refactoring-legacy-sql.md                | 2 +-
 website/docs/guides/sl-migration.md                          | 2 +-
 website/docs/guides/snowflake-qs.md                          | 3 ++-
 website/docs/guides/starburst-galaxy-qs.md                   | 3 ++-
 website/docs/guides/using-jinja.md                           | 5 +++--
 19 files changed, 30 insertions(+), 24 deletions(-)
 rename website/docs/guides/{dbt models on Databricks.md => dbt-models-on-databricks.md} (99%)

diff --git a/website/docs/guides/airflow-and-dbt-cloud.md b/website/docs/guides/airflow-and-dbt-cloud.md
index 98eb9f82d6c..6963a9b9baa 100644
--- a/website/docs/guides/airflow-and-dbt-cloud.md
+++ b/website/docs/guides/airflow-and-dbt-cloud.md
@@ -164,7 +164,9 @@ Now you have all the working pieces to get up and running with Airflow + dbt Clo
 
 ![https://lh3.googleusercontent.com/sRxe5xbv_LYhIKblc7eiY7AmByr1OibOac2_fIe54rpU3TBGwjMpdi_j0EPEFzM1_gNQXry7Jsm8aVw9wQBSNs1I6Cyzpvijaj0VGwSnmVf3OEV8Hv5EPOQHrwQgK2RhNBdyBxN2](https://lh3.googleusercontent.com/sRxe5xbv_LYhIKblc7eiY7AmByr1OibOac2_fIe54rpU3TBGwjMpdi_j0EPEFzM1_gNQXry7Jsm8aVw9wQBSNs1I6Cyzpvijaj0VGwSnmVf3OEV8Hv5EPOQHrwQgK2RhNBdyBxN2)
 
-## Add your `job_id` and `account_id` config details to the python file: [dbt_cloud_provider_eltml.py](https://github.com/sungchun12/airflow-dbt-cloud/blob/main/dags/dbt_cloud_provider_eltml.py)
+## Add your `job_id` and `account_id` config details to the python file
+
+ Add your `job_id` and `account_id` config details to the python file: [dbt_cloud_provider_eltml.py](https://github.com/sungchun12/airflow-dbt-cloud/blob/main/dags/dbt_cloud_provider_eltml.py).
 
 1. You’ll find these details within the dbt Cloud job URL, see the comments in the code snippet below for an example.
 
diff --git a/website/docs/guides/bigquery-qs.md b/website/docs/guides/bigquery-qs.md
index 5f0b641875f..d84e9a7528f 100644
--- a/website/docs/guides/bigquery-qs.md
+++ b/website/docs/guides/bigquery-qs.md
@@ -2,11 +2,10 @@
 title: "Quickstart for dbt Cloud and BigQuery"
 id: "bigquery"
 time_to_complete: '30 minutes'
-platform: 'dbt-cloud'
+level: 'Beginner'
 icon: 'bigquery'
 hide_table_of_contents: true
 tags: ['BigQuery', 'dbt Cloud']
-level: 'Beginner'
 recently_updated: true
 ---
 
diff --git a/website/docs/guides/building-packages.md b/website/docs/guides/building-packages.md
index 9d26d7c85e4..32f863271f1 100644
--- a/website/docs/guides/building-packages.md
+++ b/website/docs/guides/building-packages.md
@@ -1,5 +1,5 @@
 ---
-title: "Building dbt packages" # to do: update this to creating
+title: "Building dbt packages" 
 id: "building-packages"
 description: When you have dbt code that might help others, you can create a package for dbt using a GitHub repository. 
 displayText: Building dbt packages
@@ -7,7 +7,7 @@ hoverSnippet: Learn how to create packages for dbt.
 time_to_complete: '60 minutes'
 icon: 'guides'
 hide_table_of_contents: true
-tags: ['dbt Core', 'legacy']
+tags: ['dbt Core']
 level: 'Advanced'
 recently_updated: true
 ---
diff --git a/website/docs/guides/codespace-qs.md b/website/docs/guides/codespace-qs.md
index f30d82457a8..2f5f57677af 100644
--- a/website/docs/guides/codespace-qs.md
+++ b/website/docs/guides/codespace-qs.md
@@ -3,8 +3,9 @@ title: "Quickstart for dbt Core using GitHub Codespaces"
 id: codespace
 platform: 'dbt-core'
 icon: 'fa-github'
+level: 'Beginner'
 hide_table_of_contents: true
-tags: ['dbt Core']
+tags: ['dbt Core','Quickstart']
 ---
 
 ## Introduction
diff --git a/website/docs/guides/creating-new-materializations.md b/website/docs/guides/creating-new-materializations.md
index 12bdd0685b6..f2d1e9c40a2 100644
--- a/website/docs/guides/creating-new-materializations.md
+++ b/website/docs/guides/creating-new-materializations.md
@@ -1,14 +1,13 @@
 ---
 title: "Creating new materializations"
-id: "creating-new-materializations"
+id: creating-new-materializations
 description: Learn how to create your own materializations.
 displayText: Creating new materializations
 hoverSnippet: Learn how to create your own materializations.
 time_to_complete: '30 minutes'
-platform: 'dbt-core'
 icon: 'guides'
 hide_table_of_contents: true
-tags: ['materializations', 'dbt Core']
+tags: ['dbt Core']
 level: 'Advanced'
 recently_updated: true
 ---
diff --git a/website/docs/guides/custom-cicd-pipelines.md b/website/docs/guides/custom-cicd-pipelines.md
index 094a30eed31..5b4456c161c 100644
--- a/website/docs/guides/custom-cicd-pipelines.md
+++ b/website/docs/guides/custom-cicd-pipelines.md
@@ -92,8 +92,6 @@ This next part will happen in you code hosting platform. We need to save your AP
 }>
 <TabItem value="github">
 
-In GitHub:
-
 - Open up your repository where you want to run the pipeline (the same one that houses your dbt project)
 - Click *Settings* to open up the repository options
 - On the left click the *Security* dropdown
@@ -113,8 +111,6 @@ Here’s a video showing these steps:
 
 <TabItem value="gitlab">
 
-In GitLab:
-
 - Open up your repository where you want to run the pipeline (the same one that houses your dbt project)
 - Click *Settings* > *CI/CD*
 - Under the *Variables* section, click *Expand,* then click *Add variable*
diff --git a/website/docs/guides/databricks-qs.md b/website/docs/guides/databricks-qs.md
index cbd1c36f9a1..0aadf79c18e 100644
--- a/website/docs/guides/databricks-qs.md
+++ b/website/docs/guides/databricks-qs.md
@@ -1,10 +1,11 @@
 ---
 title: "Quickstart for dbt Cloud and Databricks"
 id: "databricks"
-platform: 'dbt-cloud'
+level: 'Beginner'
 icon: 'databricks'
 hide_table_of_contents: true
 recently_updated: true
+tags: ['dbt Cloud', 'Quickstart']
 ---
 ## Introduction
 
diff --git a/website/docs/guides/dbt models on Databricks.md b/website/docs/guides/dbt-models-on-databricks.md
similarity index 99%
rename from website/docs/guides/dbt models on Databricks.md
rename to website/docs/guides/dbt-models-on-databricks.md
index 5bb6de61e77..a205dd4fe6f 100644
--- a/website/docs/guides/dbt models on Databricks.md	
+++ b/website/docs/guides/dbt-models-on-databricks.md
@@ -1,5 +1,6 @@
 ---
 title: Optimize and troubleshoot dbt models on Databricks
+id: optimize-dbt-models-on-databricks
 sidebar_label: "Optimize and troubleshoot dbt models on Databricks"
 description: "Learn more about optimizing and troubleshooting your dbt models on Databricks"
 displayText: Optimizing and troubleshooting your dbt models on Databricks
diff --git a/website/docs/guides/debugging-schema-names.md b/website/docs/guides/debugging-schema-names.md
index fbd1ce0ae69..73b67941ee4 100644
--- a/website/docs/guides/debugging-schema-names.md
+++ b/website/docs/guides/debugging-schema-names.md
@@ -8,7 +8,7 @@ time_to_complete: '45 minutes'
 platform: 'dbt-core'
 icon: 'guides'
 hide_table_of_contents: true
-tags: ['dbt Core', 'legacy']
+tags: ['dbt Core']
 level: 'Advanced'
 recently_updated: true
 ---
diff --git a/website/docs/guides/how-to-set-up-your-databricks-dbt-project.md b/website/docs/guides/how-to-set-up-your-databricks-dbt-project.md
index 1ca1940cc50..87f313a2542 100644
--- a/website/docs/guides/how-to-set-up-your-databricks-dbt-project.md
+++ b/website/docs/guides/how-to-set-up-your-databricks-dbt-project.md
@@ -1,5 +1,6 @@
 ---
 title: How to set up your Databricks and dbt project
+id: how-to-set-up-your-databricks-dbt-project
 sidebar_label: "How to set up your Databricks and dbt project"
 description: "Learn more about setting up your dbt project with Databricks"
 displayText: Setting up your dbt project with Databricks
@@ -12,6 +13,8 @@ level: 'Intermediate'
 recently_updated: true
 ---
 
+## Introduction
+
 Databricks and dbt Labs are partnering to help data teams think like software engineering teams and ship trusted data, faster. The dbt-databricks adapter enables dbt users to leverage the latest Databricks features in their dbt project. Hundreds of customers are now using dbt and Databricks to build expressive and reliable data pipelines on the Lakehouse, generating data assets that enable analytics, ML, and AI use cases throughout the business.
 
 In this guide, we discuss how to set up your dbt project on the Databricks Lakehouse Platform so that it scales from a small team all the way up to a large organization.
diff --git a/website/docs/guides/how-to-use-databricks-workflows-to-run-dbt-cloud-jobs.md b/website/docs/guides/how-to-use-databricks-workflows-to-run-dbt-cloud-jobs.md
index f80dc081c8b..2bff4401acd 100644
--- a/website/docs/guides/how-to-use-databricks-workflows-to-run-dbt-cloud-jobs.md
+++ b/website/docs/guides/how-to-use-databricks-workflows-to-run-dbt-cloud-jobs.md
@@ -11,6 +11,7 @@ tags: ['Databricks', 'dbt Core','dbt Cloud','Orchestration']
 level: 'Intermediate'
 recently_updated: true
 ---
+
 ## Introduction
 
 Using Databricks workflows to call the dbt Cloud job API can be useful for several reasons:
diff --git a/website/docs/guides/manual-install-qs.md b/website/docs/guides/manual-install-qs.md
index 5c56f07dc5f..e49ef5bfdf7 100644
--- a/website/docs/guides/manual-install-qs.md
+++ b/website/docs/guides/manual-install-qs.md
@@ -3,8 +3,10 @@ title: "Quickstart for dbt Core from a manual install"
 id: manual-install
 description: "Connecting your warehouse to dbt Core using the CLI."
 sidebar_label: "Manual install quickstart"
+level: 'Beginner'
 platform: 'dbt-core'
 icon: 'fa-light fa-square-terminal'
+tags: ['dbt Core','Quickstart']
 hide_table_of_contents: true
 ---
 ## Introduction
diff --git a/website/docs/guides/migrating-from-spark-to-databricks.md b/website/docs/guides/migrating-from-spark-to-databricks.md
index dd128a330e3..332ba5f0573 100644
--- a/website/docs/guides/migrating-from-spark-to-databricks.md
+++ b/website/docs/guides/migrating-from-spark-to-databricks.md
@@ -5,7 +5,6 @@ description: Learn how to migrate from dbt-spark to dbt-databricks.
 displayText: Migrating from Spark to Databricks
 hoverSnippet: Learn how to migrate from dbt-spark to dbt-databricks.
 time_to_complete: '30 minutes'
-platform: ['dbt-core','dbt-cloud']
 icon: 'guides'
 hide_table_of_contents: true
 tags: ['Migration', 'dbt Core','dbt Cloud']
diff --git a/website/docs/guides/redshift-qs.md b/website/docs/guides/redshift-qs.md
index b635b86a693..d9f41be939c 100644
--- a/website/docs/guides/redshift-qs.md
+++ b/website/docs/guides/redshift-qs.md
@@ -1,11 +1,10 @@
 ---
 title: "Quickstart for dbt Cloud and Redshift"
 id: "redshift"
-platform: 'dbt-cloud'
+level: 'Beginner'
 icon: 'redshift'
 hide_table_of_contents: true
 tags: ['Redshift', 'dbt Cloud']
-level: 'Advanced'
 ---
 ## Introduction
 
diff --git a/website/docs/guides/refactoring-legacy-sql.md b/website/docs/guides/refactoring-legacy-sql.md
index 2c1bf0ead03..c64157cc24b 100644
--- a/website/docs/guides/refactoring-legacy-sql.md
+++ b/website/docs/guides/refactoring-legacy-sql.md
@@ -8,7 +8,7 @@ time_to_complete: '30 minutes'
 platform: 'dbt-cloud'
 icon: 'guides'
 hide_table_of_contents: true
-tags: ['SQL', 'legacy']
+tags: ['SQL']
 level: 'Advanced'
 recently_updated: true
 ---
diff --git a/website/docs/guides/sl-migration.md b/website/docs/guides/sl-migration.md
index fe4755c6225..031997b5e4d 100644
--- a/website/docs/guides/sl-migration.md
+++ b/website/docs/guides/sl-migration.md
@@ -12,7 +12,7 @@ level: 'Intermediate'
 recently_updated: true
 ---
 
-## introduction
+## Introduction
 
 The legacy Semantic Layer will be deprecated in H2 2023. Additionally, the `dbt_metrics` package will not be supported in dbt v1.6 and later. If you are using `dbt_metrics`, you'll need to upgrade your configurations before upgrading to v1.6. This guide is for people who have the legacy dbt Semantic Layer setup and would like to migrate to the new dbt Semantic Layer. The estimated migration time is two weeks. 
 
diff --git a/website/docs/guides/snowflake-qs.md b/website/docs/guides/snowflake-qs.md
index 33e253e8c15..4488d6b3097 100644
--- a/website/docs/guides/snowflake-qs.md
+++ b/website/docs/guides/snowflake-qs.md
@@ -1,8 +1,9 @@
 ---
 title: "Quickstart for dbt Cloud and Snowflake"
 id: "snowflake"
-platform: 'dbt-cloud'
+level: 'Beginner'
 icon: 'snowflake'
+tags: ['dbt Cloud','Quickstart']
 hide_table_of_contents: true
 ---
 ## Introduction
diff --git a/website/docs/guides/starburst-galaxy-qs.md b/website/docs/guides/starburst-galaxy-qs.md
index 33228710509..1822c83fa90 100644
--- a/website/docs/guides/starburst-galaxy-qs.md
+++ b/website/docs/guides/starburst-galaxy-qs.md
@@ -1,9 +1,10 @@
 ---
 title: "Quickstart for dbt Cloud and Starburst Galaxy"
 id: "starburst-galaxy"
-platform: 'dbt-cloud'
+level: 'Beginner'
 icon: 'starburst'
 hide_table_of_contents: true
+tags: ['dbt Cloud','Quickstart']
 ---
 ## Introduction
 
diff --git a/website/docs/guides/using-jinja.md b/website/docs/guides/using-jinja.md
index 1b2b7d7fd59..9078cb1aedd 100644
--- a/website/docs/guides/using-jinja.md
+++ b/website/docs/guides/using-jinja.md
@@ -2,14 +2,15 @@
 title: "Using Jinja"
 id: "using-jinja"
 time_to_complete: '30 minutes'
-platform: 'dbt-core'
 icon: 'guides'
 hide_table_of_contents: true
-tags: ['jinja', 'dbt Core']
+tags: ['Jinja', 'dbt Core']
 level: 'Advanced'
 recently_updated: true
 ---
 
+## Introduction
+
 In this guide, we're going to take a common pattern used in SQL, and then use Jinja to improve our code.
 
 If you'd like to work through this query, add [this CSV](https://github.com/dbt-labs/jaffle_shop/blob/core-v1.0.0/seeds/raw_payments.csv) to the `seeds/` folder of your dbt project, and then execute `dbt seed`.