diff --git a/website/docs/reference/project-configs/version.md b/website/docs/reference/project-configs/version.md
index 1c947412fcd..890ad8542a7 100644
--- a/website/docs/reference/project-configs/version.md
+++ b/website/docs/reference/project-configs/version.md
@@ -8,15 +8,17 @@ import VersionsCallout from '/snippets/_version-callout.md';
-
-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).
+
```yml
@@ -29,9 +31,9 @@ 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.
+For more on property files, see their general [documentation](/reference/configs-and-properties#where-can-i-define-properties) on the same page.
+## FAQS
-
-
-
-
-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).
-
-
-```yml
-version: version
-```
-
-
-
-## `.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.
-
-
-
-```yml
-version: 2 # Only 2 is accepted by current and recent versions of dbt.
-
-models:
- ...
-```
-
-
-
-
+