From 83f417af71a392e9fa9baf421b099b16238c8051 Mon Sep 17 00:00:00 2001
From: mirnawong1 <89008547+mirnawong1@users.noreply.github.com>
Date: Thu, 9 Nov 2023 13:49:08 +0000
Subject: [PATCH 1/3] Update version.md

fixing broken link

Resolves #4376
---
 website/docs/reference/project-configs/version.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/website/docs/reference/project-configs/version.md b/website/docs/reference/project-configs/version.md
index 1c947412fcd..7ad6fa7b7d4 100644
--- a/website/docs/reference/project-configs/version.md
+++ b/website/docs/reference/project-configs/version.md
@@ -31,7 +31,7 @@ A version tag in a `.yml` property file provides the control tag, which informs
 
 Starting from version 1.5, dbt will no longer require this configuration in your resource `.yml` files.  If you want to know more about why this tag was previously required, you can refer to the [property file FAQs](reference/configs-and-properties#faqs). 
 
-For more on property files, see their general [documentation](reference/configs-and-properties#where-can-i-define-properties) on the same page.
+For more on property files, see their general [documentation](/reference/configs-and-properties#where-can-i-define-properties) on the same page.
 
 <Tabs
   groupId="resource-version-configs"
@@ -94,7 +94,7 @@ version: version
 
 A version tag in a `.yml` property file provides the control tag, which informs how dbt processes property files. For more on why we require this tag, see property file [FAQs](reference/configs-and-properties#faqs).
 
-For more on property files, see their general [documentation](reference/configs-and-properties#where-can-i-define-properties) on the same page.
+For more on property files, see their general [documentation](/reference/configs-and-properties#where-can-i-define-properties) on the same page.
 
 <File name='<any valid filename>.yml'>
 

From 3c01cbeb76c8f1cf26a571ce44fab6810e33fff5 Mon Sep 17 00:00:00 2001
From: mirnawong1 <89008547+mirnawong1@users.noreply.github.com>
Date: Fri, 10 Nov 2023 09:59:48 +0000
Subject: [PATCH 2/3] Update version.md

consolidate
---
 .../docs/reference/project-configs/version.md | 45 +++----------------
 1 file changed, 6 insertions(+), 39 deletions(-)

diff --git a/website/docs/reference/project-configs/version.md b/website/docs/reference/project-configs/version.md
index 7ad6fa7b7d4..aa4ef205e7a 100644
--- a/website/docs/reference/project-configs/version.md
+++ b/website/docs/reference/project-configs/version.md
@@ -8,15 +8,15 @@ import VersionsCallout from '/snippets/_version-callout.md';
 
 <VersionsCallout />
 
-<VersionBlock firstVersion="1.5">
 
-dbt projects have two distinct types of the `version` tags. This field has a different meaning depending on its location.
+dbt projects have two distinct types of `version` tags. This field has a different meaning depending on its location.
 
 ## `dbt_project.yml` versions
 
-The version tag in a `dbt_project` file represents the version of your dbt project. Starting in version 1.5, `version` in the `dbt_project.yml` is an *optional parameter*. If specified, the version must be in a [semantic version](https://semver.org/) format, e.g. `1.0.0`. The default value if not specified is `None`. 
+The version tag in a `dbt_project` file represents the version of your dbt project. Starting in dbt version 1.5, `version` in the `dbt_project.yml` is an *optional parameter*. If used, the version must be in a [semantic version](https://semver.org/) format, such as `1.0.0`. The default value is `None` if not specified. For users on dbt version 1.4 or lower, this tag is required, though it isn't currently used meaningfully by dbt.
 
 For more on Core versions, see [About dbt Core versions](/docs/dbt-versions/core).
+
 <File name='dbt_project.yml'>
 
 ```yml
@@ -29,7 +29,7 @@ version: version
 
 A version tag in a `.yml` property file provides the control tag, which informs how dbt processes property files. 
 
-Starting from version 1.5, dbt will no longer require this configuration in your resource `.yml` files.  If you want to know more about why this tag was previously required, you can refer to the [property file FAQs](reference/configs-and-properties#faqs). 
+Starting from version 1.5, dbt will no longer require this configuration in your resource `.yml` files.  If you want to know more about why this tag was previously required, you can refer to the [FAQs](#faqs). For users on dbt version 1.4 or lower, this tag is required,
 
 For more on property files, see their general [documentation](/reference/configs-and-properties#where-can-i-define-properties) on the same page.
 
@@ -72,39 +72,6 @@ models:
 
 </Tabs>
 
+## FAQS
 
-</VersionBlock>
-
-<VersionBlock lastVersion="1.4">
-
-dbt projects have two distinct types of `version` tags. This field has a different meaning depending on its location.
-
-## `dbt_project.yml` versions
-
-The version tag in a `dbt_project` file represents the version of your dbt project and **is a required parameter**. However, it isn't currently used in a meaningful way by dbt. The version must follow a [semantic version](https://semver.org/) format, such as 1.0.0. For more information about dbt Core versions, refer to [About dbt Core versions](/docs/dbt-versions/core).
-<File name='dbt_project.yml'>
-
-```yml
-version: version
-```
-
-</File>
-
-## `.yml` property file versions
-
-A version tag in a `.yml` property file provides the control tag, which informs how dbt processes property files. For more on why we require this tag, see property file [FAQs](reference/configs-and-properties#faqs).
-
-For more on property files, see their general [documentation](/reference/configs-and-properties#where-can-i-define-properties) on the same page.
-
-<File name='<any valid filename>.yml'>
-
-```yml
-version: 2  # Only 2 is accepted by current and recent versions of dbt.
-
-models: 
-    ...
-```
-
-</File>
-
-</VersionBlock>
+<FAQ path="Project/why-version-2" />

From 406fc5d919cdf8d8dc11d6431ce53962d09296f3 Mon Sep 17 00:00:00 2001
From: mirnawong1 <89008547+mirnawong1@users.noreply.github.com>
Date: Fri, 10 Nov 2023 10:06:33 +0000
Subject: [PATCH 3/3] Update version.md

---
 website/docs/reference/project-configs/version.md | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/website/docs/reference/project-configs/version.md b/website/docs/reference/project-configs/version.md
index aa4ef205e7a..890ad8542a7 100644
--- a/website/docs/reference/project-configs/version.md
+++ b/website/docs/reference/project-configs/version.md
@@ -13,7 +13,9 @@ dbt projects have two distinct types of `version` tags. This field has a differe
 
 ## `dbt_project.yml` versions
 
-The version tag in a `dbt_project` file represents the version of your dbt project. Starting in dbt version 1.5, `version` in the `dbt_project.yml` is an *optional parameter*. If used, the version must be in a [semantic version](https://semver.org/) format, such as `1.0.0`. The default value is `None` if not specified. For users on dbt version 1.4 or lower, this tag is required, though it isn't currently used meaningfully by dbt.
+The version tag in a `dbt_project` file represents the version of your dbt project. 
+
+Starting in dbt version 1.5, `version` in the `dbt_project.yml` is an *optional parameter*. If used, the version must be in a [semantic version](https://semver.org/) format, such as `1.0.0`. The default value is `None` if not specified. For users on dbt version 1.4 or lower, this tag is required, though it isn't currently used meaningfully by dbt.
 
 For more on Core versions, see [About dbt Core versions](/docs/dbt-versions/core).