From 9ecd669df2901b0236e7059f3b2efdaecb16dd2d Mon Sep 17 00:00:00 2001 From: mirnawong1 <89008547+mirnawong1@users.noreply.github.com> Date: Mon, 13 Nov 2023 12:34:08 +0000 Subject: [PATCH 01/11] Create _config-description-general.md --- website/snippets/_config-description-general.md | 1 + 1 file changed, 1 insertion(+) create mode 100644 website/snippets/_config-description-general.md diff --git a/website/snippets/_config-description-general.md b/website/snippets/_config-description-general.md new file mode 100644 index 00000000000..04966047e2c --- /dev/null +++ b/website/snippets/_config-description-general.md @@ -0,0 +1 @@ +General configurations provide broader operational settings applicable across multiple resources. These include enabling/disabling resources, tagging, database and schema specifications, and operational settings like pre-hooks and post-hooks. These can also be set in the project file, property file, or within the resource file. From c274dcd4348748839cec542d45ed8f7faccc9050 Mon Sep 17 00:00:00 2001 From: mirnawong1 <89008547+mirnawong1@users.noreply.github.com> Date: Mon, 13 Nov 2023 12:35:15 +0000 Subject: [PATCH 02/11] Create _config-description-resource.md --- website/snippets/_config-description-resource.md | 1 + 1 file changed, 1 insertion(+) create mode 100644 website/snippets/_config-description-resource.md diff --git a/website/snippets/_config-description-resource.md b/website/snippets/_config-description-resource.md new file mode 100644 index 00000000000..4fda2ab74b8 --- /dev/null +++ b/website/snippets/_config-description-resource.md @@ -0,0 +1 @@ +Resource-specific configurations are applied to individual dbt resources, influencing their specific attributes. These settings can be defined in the project file (`dbt_project.yml`), a property file (`models/properties.yml` for models, similarly for other resources), or within the resource’s file using the `{{ config() }}` macro. From 0d7dc2979f9d58e8716a5dc9fff8f6a520bc2b6c Mon Sep 17 00:00:00 2001 From: mirnawong1 <89008547+mirnawong1@users.noreply.github.com> Date: Mon, 13 Nov 2023 12:36:41 +0000 Subject: [PATCH 03/11] Update model-configs.md --- website/docs/reference/model-configs.md | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/website/docs/reference/model-configs.md b/website/docs/reference/model-configs.md index 06830d0d32b..c4de3697abe 100644 --- a/website/docs/reference/model-configs.md +++ b/website/docs/reference/model-configs.md @@ -3,6 +3,9 @@ title: Model configurations description: "Read this guide to understand model configurations in dbt." --- +import ConfigResource from '/snippets/_config-description-resource.md'; +import ConfigGeneral from '/snippets/_config-description-general.md'; + ## Related documentation * [Models](/docs/build/models) * [`run` command](/reference/commands/run) @@ -10,6 +13,8 @@ description: "Read this guide to understand model configurations in dbt." ## Available configurations ### Model-specific configurations + + + Date: Mon, 13 Nov 2023 12:55:01 +0000 Subject: [PATCH 04/11] clarify lang --- website/docs/reference/seed-configs.md | 8 ++++++++ website/docs/reference/snapshot-configs.md | 9 +++++++++ website/docs/reference/source-configs.md | 4 ++++ website/docs/reference/test-configs.md | 7 +++++++ website/snippets/_config-description-general.md | 2 +- website/snippets/_config-description-resource.md | 2 +- 6 files changed, 30 insertions(+), 2 deletions(-) diff --git a/website/docs/reference/seed-configs.md b/website/docs/reference/seed-configs.md index 429aa9444ae..a2c1f50b42f 100644 --- a/website/docs/reference/seed-configs.md +++ b/website/docs/reference/seed-configs.md @@ -3,9 +3,15 @@ title: Seed configurations description: "Read this guide to learn about using seed configurations in dbt." --- +import ConfigResource from '/snippets/_config-description-resource.md'; +import ConfigGeneral from '/snippets/_config-description-general.md'; + + ## Available configurations ### Seed-specific configurations + + + + + + + + Date: Mon, 13 Nov 2023 13:32:08 +0000 Subject: [PATCH 05/11] add code --- website/snippets/_config-description-resource.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/website/snippets/_config-description-resource.md b/website/snippets/_config-description-resource.md index dc826ea1ca4..18ac7307a96 100644 --- a/website/snippets/_config-description-resource.md +++ b/website/snippets/_config-description-resource.md @@ -1 +1 @@ -Resource-specific configurations are applied to individual dbt resources. They influence specific attributes of the resource, such as [sql-header](/reference/resource-configs/sql_header), [column_types](/reference/resource-configs/column_types), [strategy](/reference/resource-configs/strategy), and so on. You can define these settings in the project file (`dbt_project.yml`), a property file (`models/properties.yml` for models, similarly for other resources), or within the resource’s file using the `{{ config() }}` macro. +Resource-specific configurations are applied to individual dbt resources. They influence specific attributes of the resource, such as [`sql-header`](/reference/resource-configs/sql_header), [`column_types`](/reference/resource-configs/column_types), [`strategy`](/reference/resource-configs/strategy), and so on. You can define these settings in the project file (`dbt_project.yml`), a property file (`models/properties.yml` for models, similarly for other resources), or within the resource’s file using the `{{ config() }}` macro. From 33c6038cbc08923e870e0fc0dd6a96bb0d206388 Mon Sep 17 00:00:00 2001 From: mirnawong1 <89008547+mirnawong1@users.noreply.github.com> Date: Fri, 17 Nov 2023 15:44:43 +0000 Subject: [PATCH 06/11] Update website/snippets/_config-description-general.md Co-authored-by: Doug Beatty <44704949+dbeatty10@users.noreply.github.com> --- website/snippets/_config-description-general.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/website/snippets/_config-description-general.md b/website/snippets/_config-description-general.md index fa404cddeb6..ef30901be7b 100644 --- a/website/snippets/_config-description-general.md +++ b/website/snippets/_config-description-general.md @@ -1 +1 @@ -General configurations provide broader operational settings applicable across multiple resources. These include enabling or disabling resources, tagging, database and schema specifications, and operational settings like pre-hooks and post-hooks. These can also be set in the project file, property file, or within the resource file. +General configurations provide broader operational settings applicable across multiple resource types. Like resource-specific configurations, these can also be set in the project file, property files, or within resource-specific files. From ed03907b5398fae735940b5dff6655807d542ead Mon Sep 17 00:00:00 2001 From: mirnawong1 <89008547+mirnawong1@users.noreply.github.com> Date: Fri, 17 Nov 2023 15:45:06 +0000 Subject: [PATCH 07/11] Update website/snippets/_config-description-resource.md Co-authored-by: Doug Beatty <44704949+dbeatty10@users.noreply.github.com> --- website/snippets/_config-description-resource.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/website/snippets/_config-description-resource.md b/website/snippets/_config-description-resource.md index 18ac7307a96..a1552046019 100644 --- a/website/snippets/_config-description-resource.md +++ b/website/snippets/_config-description-resource.md @@ -1 +1 @@ -Resource-specific configurations are applied to individual dbt resources. They influence specific attributes of the resource, such as [`sql-header`](/reference/resource-configs/sql_header), [`column_types`](/reference/resource-configs/column_types), [`strategy`](/reference/resource-configs/strategy), and so on. You can define these settings in the project file (`dbt_project.yml`), a property file (`models/properties.yml` for models, similarly for other resources), or within the resource’s file using the `{{ config() }}` macro. +Resource-specific configurations are applicable to only one dbt resource type rather than multiple resource types. You can define these settings in the project file (`dbt_project.yml`), a property file (`models/properties.yml` for models, similarly for other resources), or within the resource’s file using the `{{ config() }}` macro. From efae7324cdc667ab5ced4d0e147182ee4dc9ddfc Mon Sep 17 00:00:00 2001 From: mirnawong1 Date: Fri, 17 Nov 2023 16:28:45 +0000 Subject: [PATCH 08/11] add props --- website/docs/reference/model-configs.md | 4 +++- website/docs/reference/seed-configs.md | 4 +++- website/docs/reference/snapshot-configs.md | 4 +++- website/docs/reference/test-configs.md | 4 +++- website/snippets/_config-description-resource.md | 2 +- 5 files changed, 13 insertions(+), 5 deletions(-) diff --git a/website/docs/reference/model-configs.md b/website/docs/reference/model-configs.md index c4de3697abe..19391f1c763 100644 --- a/website/docs/reference/model-configs.md +++ b/website/docs/reference/model-configs.md @@ -1,6 +1,8 @@ --- title: Model configurations description: "Read this guide to understand model configurations in dbt." +meta: + resource_type: Models --- import ConfigResource from '/snippets/_config-description-resource.md'; @@ -13,7 +15,7 @@ import ConfigGeneral from '/snippets/_config-description-general.md'; ## Available configurations ### Model-specific configurations - + + + +
The following resource-specific config code block is only available to {props.meta.resource_type}. From 8065d3819a279bbd7f99304e4e4c9764967bf87b Mon Sep 17 00:00:00 2001 From: mirnawong1 Date: Fri, 17 Nov 2023 17:56:11 +0000 Subject: [PATCH 09/11] new line --- website/snippets/_config-description-resource.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/website/snippets/_config-description-resource.md b/website/snippets/_config-description-resource.md index c87dc6cf21f..90240816300 100644 --- a/website/snippets/_config-description-resource.md +++ b/website/snippets/_config-description-resource.md @@ -1 +1,3 @@ -Resource-specific configurations are applicable to only one dbt resource type rather than multiple resource types. You can define these settings in the project file (`dbt_project.yml`), a property file (`models/properties.yml` for models, similarly for other resources), or within the resource’s file using the `{{ config() }}` macro.

The following resource-specific config code block is only available to {props.meta.resource_type}. +Resource-specific configurations are applicable to only one dbt resource type rather than multiple resource types. You can define these settings in the project file (`dbt_project.yml`), a property file (`models/properties.yml` for models, similarly for other resources), or within the resource’s file using the `{{ config() }}` macro.

+ +The following resource-specific config code block is only available to {props.meta.resource_type}. From d3ee0cb1b33c9c8f00bc8d41d71facbfdfe219a2 Mon Sep 17 00:00:00 2001 From: mirnawong1 Date: Fri, 17 Nov 2023 17:59:35 +0000 Subject: [PATCH 10/11] fix --- website/snippets/_config-description-resource.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/website/snippets/_config-description-resource.md b/website/snippets/_config-description-resource.md index 90240816300..8e691daef5f 100644 --- a/website/snippets/_config-description-resource.md +++ b/website/snippets/_config-description-resource.md @@ -1,3 +1,3 @@ -Resource-specific configurations are applicable to only one dbt resource type rather than multiple resource types. You can define these settings in the project file (`dbt_project.yml`), a property file (`models/properties.yml` for models, similarly for other resources), or within the resource’s file using the `{{ config() }}` macro.

+Resource-specific configurations are applicable to only one dbt resource type rather than multiple resource types. You can define these settings in the project file (`dbt_project.yml`), a property file (`models/properties.yml` for models, similarly for other resources), or within the resource’s file using the `{{ config() }}` macro.
-The following resource-specific config code block is only available to {props.meta.resource_type}. +The following resource-specific config code block is only available to {props.meta.resource_type}: From fb2b1a2e437c9f40311525998a9bfc6de97a9c8e Mon Sep 17 00:00:00 2001 From: mirnawong1 <89008547+mirnawong1@users.noreply.github.com> Date: Fri, 17 Nov 2023 18:27:50 +0000 Subject: [PATCH 11/11] Update website/snippets/_config-description-resource.md Co-authored-by: Doug Beatty <44704949+dbeatty10@users.noreply.github.com> --- website/snippets/_config-description-resource.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/website/snippets/_config-description-resource.md b/website/snippets/_config-description-resource.md index 8e691daef5f..a0910631338 100644 --- a/website/snippets/_config-description-resource.md +++ b/website/snippets/_config-description-resource.md @@ -1,3 +1,3 @@ Resource-specific configurations are applicable to only one dbt resource type rather than multiple resource types. You can define these settings in the project file (`dbt_project.yml`), a property file (`models/properties.yml` for models, similarly for other resources), or within the resource’s file using the `{{ config() }}` macro.
-The following resource-specific config code block is only available to {props.meta.resource_type}: +The following resource-specific configurations are only available to {props.meta.resource_type}: