From 208949ac6bc94f161f313d737cac8c2084e48d96 Mon Sep 17 00:00:00 2001
From: rkoron007 <rkoron007@gmail.com>
Date: Wed, 19 Mar 2025 16:43:04 -0700
Subject: [PATCH 01/12] Add the check block reference

---
 website/data/language-nav-data.json    |  13 +-
 website/docs/language/block/check.mdx  | 241 +++++++++++++++++++++++++
 website/docs/language/checks/index.mdx | 121 -------------
 3 files changed, 253 insertions(+), 122 deletions(-)
 create mode 100644 website/docs/language/block/check.mdx
 delete mode 100644 website/docs/language/checks/index.mdx

diff --git a/website/data/language-nav-data.json b/website/data/language-nav-data.json
index 06b7b94b65a7..779d2d7c8d38 100644
--- a/website/data/language-nav-data.json
+++ b/website/data/language-nav-data.json
@@ -332,7 +332,7 @@
       }
     ]
   },
-  { "title": "Checks", "path": "checks" },
+
   {
       "title": "Import",
       "routes": [
@@ -1109,5 +1109,16 @@
     "path": "v1-compatibility-promises"
   },
   { "divider": true },
+  { "heading": "REFERENCE" },
+  {
+    "title": "Configuration blocks",
+    "routes": [
+      {
+        "title": "check",
+        "path": "block/check"
+      }
+    ]
+  },
+  { "divider": true },
   { "title": "Terraform Internals", "href": "/internals" }
 ]
diff --git a/website/docs/language/block/check.mdx b/website/docs/language/block/check.mdx
new file mode 100644
index 000000000000..17881df0ee7a
--- /dev/null
+++ b/website/docs/language/block/check.mdx
@@ -0,0 +1,241 @@
+---
+page_title: Check block reference
+description: How to use the `check` block to validate infrastructure outside of the usual resource lifecycle.
+---
+
+# `check` block
+
+The `check` block validates infrastructure outside the plan and apply lifecycle, allowing ongoing verification of your infrastructure.
+
+The `check` block executes as the last step of plan or apply operations after Terraform has planned or provisioned your infrastructure. When a `check` block's assertion fails, Terraform reports a warning and continues executing the current operation. 
+
+## Background
+
+Terraform evaluates `check` blocks locally whenever you plan or apply your configuration. In HCP Terraform, you can enable health checks on a workspace to automatically and continuously execute checks defined in that workspace's configuration. Refer to [Continuous validation](/terraform/cloud-docs/workspaces/health#continuous-validation) for details.
+
+The `check` block is one of the Terraform configuration language's validation rules. Other validation rules run during other stages of a Terraform operation, and can block operations if they fail. However, the `check` block is the only validation rule that does not block operations, instead Terraform produces a warning and lets that operation continue. For information on other validation rules, refer to [Validate your configuration](/terraform/language/expressions/custom-conditions).
+
+<!-- TODO: Fix link once have Validate your configuration page -->
+
+## Configuration model
+
+The `check` block supports the following arguments: 
+
+- [`check "<LABEL>"`](#check) &nbsp; block
+  - [`assert`](#assert) &nbsp; block (required)
+    - [`condition`](#assert) &nbsp; expression
+    - [`error_message`](#assert) &nbsp; string
+  - [`data "<TYPE>" "<LABEL>"`](#data) &nbsp; block
+    - [`PROVIDER_ARGUMENTS`](#provider_arguments) &nbsp; block | refer to your provider documentation
+    - [`depends_on`](#depends_on) &nbsp; list of references
+    - [`provider`](#provider) &nbsp; reference
+
+## Complete configuration
+
+All available arguments are defined in the following `check` block. There are no mutually exclusive arguments for a `check` block.
+
+```hcl
+check "<LABEL>" {
+  data "<TYPE>" "<LABEL>" {
+    <DATA_CONFIGURATION>
+  }
+
+  assert {
+    condition     = <EXPRESSION>
+    error_message = "<error message string>"
+  }
+}
+```
+
+A `check` block can contain [multiple assertions](#multiple-assertions). 
+
+## Specification
+
+A `check` block supports the following configuration. 
+
+### `check "<LABEL>"`
+
+While declaring a `check` block, you must add a unique label that starts with a letter or underscore and contains only letters, digits, underscores, and dashes.
+
+You can define the following blocks on a `check` block. A `check` block's assertion(s) are the conditions the check verifies.
+
+| Argument | Description | Type | Required |  
+| --- | --- | --- | --- |  
+| `assert` | The validation condition to evaluate. A check block contains one or more assertions. | Block | Required |  
+| `data` | One nested data source to use for validation. You can only reference this data source within its enclosing `check` block. | Block | Optional |
+
+### `assert`
+
+A `check` block must contain at least one `assert` block. Each `assert` block specifies a condition that Terraform evaluates after plan and apply operations. 
+
+```hcl
+check "unique_name" {
+  assert {
+    condition     = <expression-to-verify>
+    error_message = "The error message Terraform displays if the assert expression is false."
+  }
+}
+```
+
+For a check to pass, each `assert` block's `condition` must evaluate to `true`. The `condition` arguments within an `assert` block can reference nested data sources within the enclosing `check` block and any variables, resources, data sources, or module outputs within the current module.
+
+The `assert` block supports the following arguments:
+
+| Argument | Description | Type | Required |  
+| --- | --- | --- | --- |  
+| `condition` | Expression that Terraform evaluates. If the expression evaluates to `true`, then the `assert` block passes. | Expression | Required |  
+| `error_message` | Message to display if the condition evaluates to `false`. | String | Required |
+
+Refer to the [examples](#examples) to learn more about defining assertions within a `check` block.
+
+#### Summary
+
+- Data type: Block.   
+- Default: None.   
+- Required: Yes, each `check` block must contain at least one `assert` block.  
+- Example: [Declare multiple assertions](#multiple-assetions).
+
+### `data "<TYPE>" "<LABEL>"`
+
+You can optionally declare a `data` block within a `check` block to create a nested data source that lets you fetch information to reference in your conditions.
+
+```hcl
+check "unique_name" {
+  data "TYPE" "<LABEL>" {
+    <provider_specific_arguments>
+  }
+
+  assert { #... }
+}
+```
+
+You can only reference a nested data source within its enclosing `check` block. If a nested data source's provider raises errors, they are masked as warnings and do not prevent the Terraform operation from continuing.
+
+Unlike other [data sources](/terraform/language/data-sources), Terraform fetches the information for nested data sources as the final step of a plan or apply operation. You can use nested data sources to fetch information about your infrastructure after Terraform has applied the rest of your configuration. For example, you can use a nested `data` block to ping your website's API to ensure Terraform successfully applied and built your website's infrastructure.
+
+A nested `data` block requires a type and a label:
+
+- `TYPE`: Specifies the type of data source to use.  
+- `LABEL`: A unique name for this data source. Refer to [Resource naming](/terraform/language/style#resource-naming) for label recommendations.
+
+The arguments within a `data` block are provider-specific. Refer to the [registry documentation](https://registry.terraform.io/) for your specified provider for details. 
+
+### `depends_on`
+
+You can use the `depends_on` meta-argument in a nested data source if it depends on another resource to fetch information.
+
+```hcl
+check "unique_name" {
+  data "aws_ami" "web" {
+    <provider_specific_arguments>
+    depends_on = [<another_resource.name>]
+  }
+
+  assert { #... }
+}
+```
+
+We recommend adding the `depends_on` meta-argument if your nested data source depends on another resource without referencing that resource directly.
+
+For example, if you define a `check` that verifies that a website API returns `200`, that check will fail the first time Terraform runs your configuration because your website's infrastructure will not exist yet. You can set the `depends_on` argument to a resource such as the load balancer to ensure Terraform only runs the `check` once the website is up. When running an operation, Terraform evaluates the `check`, warns `known after apply` until that crucial piece of your website is ready, and continues the operation. 
+
+However, this strategy only works if your nested data source does not directly reference the resource it `depends_on`. Otherwise, anytime that resource changes, the `check` block warns `known after apply` until Terraform updates that resource, making your check potentially noisy and ineffective. Refer to the [example](#resource-dependency) for more details.
+
+The `depends_on` block is a meta-argument. Meta-arguments are built-in arguments that control how Terraform creates resources. Refer to [Meta-arguments](/terraform/language/meta-arguments/depends_on) for additional information. 
+
+<!-- TODO: Update meta-arguments concept link once we have the page -->
+
+### `provider`
+
+The `provider` argument instructs Terraform to use an alternate provider configuration to provision the nested data source. 
+
+```hcl
+check "unique_name" {
+  data "aws_ami" "web" {
+    <provider_specific_arguments>
+    provider = <provider>.<alias>
+  }
+
+  assert { #... }
+}
+```
+
+By default, Terraform automatically selects a provider based on the data source's type, but you can create multiple provider configurations and use a non-default configuration for specific resources. 
+
+The `provider` argument is a meta-argument, which is built into Terraform and controls the way that Terraform creates resources. Refer to [Meta-arguments](/terraform/language/meta-arguments/resource-provider) for additional information.
+
+<!-- TODO: Update meta-arguments concept link once we have the page -->
+
+#### Summary
+
+- Data type: Block.
+- Default: None.
+- Supported meta-arguments: `depends_on` and `provider`.
+- Example: [Resource dependency](#resource-dependency).
+
+## Examples
+
+The following examples demonstrate common use cases for `check` blocks.
+
+### Validate endpoint health
+
+The following example validates that an endpoint returns a healthy status code:
+
+```hcl
+check "health_check" {
+  data "http" "endpoint" {
+    url = "https://api.example.com/health"
+  }
+
+  assert {
+    condition     = data.http.endpoint.status_code == 200
+    error_message = "Health check failed: ${data.http.endpoint.url} returned ${data.http.endpoint.status_code}"
+  }
+}
+```
+
+This check uses a nested data source to check an endpoint's status code. If the endpoint returns a `200` then the check passes.  
+
+### Multiple assertions
+
+This example shows how to construct a check that uses multiple assertions:
+
+```hcl
+check "service_validation" {
+  data "aws_lb" "app" {
+    name = "application-lb"
+  }
+
+  assert {
+    condition     = data.aws_lb.app.enable_deletion_protection
+    error_message = "Load balancer must have deletion protection enabled"
+  }
+
+  assert {
+    condition     = length(data.aws_lb.app.security_groups) > 0
+    error_message = "Load balancer must have at least one security group"
+  }
+}
+```
+
+The check passes if the load balancer has at least one security group attached and has deletion protection enabled. 
+
+### Resource dependency
+
+This example shows how to use `depends_on` to ensure the check only runs after a resource is available:
+
+```hcl
+check "database_connection" {
+  data "postgresql_database" "app_db" {
+    name       = "application"
+    depends_on = [aws_db_instance.main]
+  }
+
+  assert {
+    condition     = data.postgresql_database.app_db.allow_connections
+    error_message = "Database is not accepting connections"
+  }
+}
+```
+
+The check warns `known after apply` during operations until Terraform creates the `aws_db_instance.main` database, meaning the check won't throw false warnings until Terraform creates that resource.
\ No newline at end of file
diff --git a/website/docs/language/checks/index.mdx b/website/docs/language/checks/index.mdx
deleted file mode 100644
index 021ee582c1cd..000000000000
--- a/website/docs/language/checks/index.mdx
+++ /dev/null
@@ -1,121 +0,0 @@
----
-page_title: Checks - Configuration Language
-description: >-
-  Check customized infrastructure requirements to provide ongoing and continuous verification.
----
-
-# Checks
-
--> **Note:** Check blocks are only available in Terraform v1.5.0 and later.
-
-The `check` block can validate your infrastructure outside the usual resource lifecycle. Check blocks address a gap between post-apply and functional validation of infrastructure.
-
-> **Hands-on:** Try the [Validate Infrastructure Using Checks](/terraform/tutorials/configuration-language/checks) tutorial.
-
-Check blocks allow you to define [custom conditions](/terraform/language/expressions/custom-conditions) that execute on every Terraform plan or apply operation without affecting the overall status of an operation. Check blocks execute as the last step of a plan or apply after Terraform has planned or provisioned your infrastructure.
-
-## Syntax
-
-You can declare a `check` block with a local name, zero-to-one scoped [data sources](#scoped-data-sources), and one-to-many [assertions](#assertions).
-
-The following example loads the Terraform website and validates that it returns the expected status code `200`.
-
-```hcl
-check "health_check" {
-  data "http" "terraform_io" {
-    url = "https://www.terraform.io"
-  }
-
-  assert {
-    condition = data.http.terraform_io.status_code == 200
-    error_message = "${data.http.terraform_io.url} returned an unhealthy status code"
-  }
-}
-```
-
-### Scoped data sources
-
-You can use any data source from any provider as a scoped data source within a `check` block.
-
-A `check` block can optionally contain a nested (a.k.a. scoped) data source. This `data` block behaves like an external [data source](/terraform/language/data-sources), except you can not reference it outside its enclosing `check` block. Additionally, if a scoped data source's provider raises any errors, they are masked as warnings and do not prevent Terraform from continuing operation execution.
-
-You can use a scoped data source to validate the status of a piece of infrastructure outside of the usual Terraform resource lifecycle. [In the above example](#checks-syntax), if the `terraform_io` data source fails to load, you receive a warning instead of a blocking error, which would occur if you declared this data source outside of a `check` block.
-
-#### Meta-Arguments
-
-Scoped data sources support the `depends_on` and `provider` [meta-arguments](/terraform/language/resources/syntax#meta-arguments). Scoped data sources do not support the `count` or`for_each` meta-arguments.
-
-##### `depends_on`
-
-The `depends_on` meta-argument can be particularly powerful when used within scoped data sources.
-
-The first time Terraform creates the _initial_ plan for our [previous example](#checks-syntax), the plan fails because Terraform has not applied its configuration yet. Meaning this test fails because Terraform must still create the resources to make this website exist. Therefore, the first time Terraform runs this check, it always throws a potentially distracting error message.
-
-You can fix this by adding [`depends_on`](/terraform/language/meta-arguments/depends_on) to your scoped data source, ensuring it depends on an essential piece of your site's infrastructure, such as the load balancer. The check returns  `known after apply` until that crucial piece of your website is ready. This strategy avoids producing unnecessary warnings during setup, and the check executes during subsequent plans and applies.
-
-One problem with this strategy is that if the resource your scoped data source `depends_on` changes, the check block returns `known after apply` until Terraform has updated that resource. Depending on your use case, this behavior could be acceptable or problematic.
-
-We recommend implementing the `depends_on` meta-argument if your scoped data source depends on the existence of another resource without referencing it directly.
-
-### Assertions
-
-Check blocks validate your custom assertions using `assert` blocks. Each `check` block must have at least one, but potentially many, `assert` blocks. Each `assert` block has a [`condition` attribute](/terraform/language/expressions/custom-conditions#condition-expressions) and an [`error_message` attribute](/terraform/language/expressions/custom-conditions#error-messages).
-
-Unlike other [custom conditions](/terraform/language/expressions/custom-conditions), assertions do not affect Terraform's execution of an operation. A failed assertion reports a warning without halting the ongoing operation. This contrasts with other custom conditions, such as a postcondition, where Terraform produces an error immediately, halting the operation and blocking the application or planning of future resources.
-
-Condition arguments within `assert` blocks can refer to scoped data sources within the enclosing `check` block and any variables, resources, data sources, or module outputs within the current module.
-
-[Learn more about assertions](/terraform/language/expressions/custom-conditions#checks-with-assertions).
-
-### Meta-Arguments
-
-Check blocks do not currently support [meta-arguments](/terraform/language/resources/syntax#meta-arguments). We are still collecting feedback on this feature, so if your use case would benefit from check blocks supporting meta-arguments, please [let us know](https://github.com/hashicorp/terraform/issues/new/choose).
-
-## Continuous validation in HCP Terraform
-
-HCP Terraform can automatically validate whether checks in a workspace’s configuration continue to pass after Terraform provisions new infrastructure. See [Continuous Validation](/terraform/cloud-docs/workspaces/health#continuous-validation) for details.
-
-## Choosing Checks or other Custom Conditions
-
-Check blocks offer the most _flexible_ validation solution within Terraform. You can reference outputs, variables, resources, and data sources within check assertions. You can also use checks to model every alternate [Custom Condition](/terraform/language/expressions/custom-conditions). However, that does not mean you should replace all your custom conditions with check blocks.
-
-There are major behavioral differences between check block assertions and other custom conditions, the main one being that check blocks do _not_ affect Terraform's execution of an operation. You can use this non-blocking behavior to decide the best type of validation for your use case.
-
-### Outputs and variables
-
-[Output postconditions](/terraform/language/expressions/custom-conditions#outputs) and [variable validations](/terraform/language/expressions/custom-conditions#input-variable-validation) both make assertions around inputs and outputs.
-
-This is one of the cases where you might want Terraform to block further execution. 
-
-For example, it is not helpful for Terraform to warn that an input variable is invalid after it applies an entire configuration with that input variable. In this case, a check block would warn of the invalid input variable _without_ interrupting the operation. A validation block for the same input variable would alert you of the invalid variable and halt the plan or apply operation.
-
-### Resource Preconditions and Postconditions
-
-The difference between [preconditions and postconditions](/terraform/language/expressions/custom-conditions#preconditions-and-postconditions) and check blocks is more nuanced.
-
-Preconditions are unique amongst the custom conditions in that they execute _before_ a resource change is applied or planned. [Choosing Between Preconditions and Postconditions](/terraform/language/expressions/custom-conditions#choosing-between-preconditions-and-postconditions) offers guidance on choosing between a precondition and a postcondition, and the same topics also apply to choosing between a precondition and a check block.
-
-You can often use postconditions interchangeably with check blocks to validate resources and data sources.
-
-For example, you can [rewrite the above `check` block example](#syntax) to use a postcondition instead. The below code uses a `postcondition` block to validate that the Terraform website returns the expected status code of `200`.
-
-```hcl
-data "http" "terraform_io" {
-  url = "https://www.terraform.io"
-
-  lifecycle {
-    postcondition {
-        condition = self.status_code == 200
-        error_message = "${self.url} returned an unhealthy status code"
-    }
-  }
-}
-```
-
-Both the `check` and `postcondition` block examples validate that the Terraform website returns a `200` status code during a plan or an apply operation. The difference between the two blocks is how each handles failure.
-
-If a `postcondition` block fails, it _blocks_ Terraform from executing the current operation. If a `check` block fails, it _does not_ block Terraform from executing an operation.
-
-If the above example's postcondition fails, it is impossible to recover from. Terraform blocks any future plan or apply operations if your postcondition is unsatisfied during the planning stage. This problem occurs because the postcondition does not directly depend on Terraform configuration, but instead on the complex interactions between multiple resources.
-
-We recommend using check blocks to validate the status of infrastructure as a whole. We only recommend using postconditions when you want a guarantee on a single resource based on that resource's configuration.

From 1f4ae502d2e2525b701c046ed15d7edfc5dfdf94 Mon Sep 17 00:00:00 2001
From: rkoron007 <rkoron007@gmail.com>
Date: Thu, 20 Mar 2025 12:29:32 -0700
Subject: [PATCH 02/12] Small tweaks

---
 website/docs/language/block/check.mdx | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/website/docs/language/block/check.mdx b/website/docs/language/block/check.mdx
index 17881df0ee7a..eb3cbfcd0d07 100644
--- a/website/docs/language/block/check.mdx
+++ b/website/docs/language/block/check.mdx
@@ -5,15 +5,15 @@ description: How to use the `check` block to validate infrastructure outside of
 
 # `check` block
 
-The `check` block validates infrastructure outside the plan and apply lifecycle, allowing ongoing verification of your infrastructure.
+Use the `check` block to validate your infrastructure outside of the typical resource lifecycle.
 
-The `check` block executes as the last step of plan or apply operations after Terraform has planned or provisioned your infrastructure. When a `check` block's assertion fails, Terraform reports a warning and continues executing the current operation. 
+The `check` block executes as the last step of plan or apply operation, after Terraform has planned or provisioned your infrastructure. When a `check` block's assertion fails, Terraform reports a warning and continues executing the current operation. 
 
 ## Background
 
 Terraform evaluates `check` blocks locally whenever you plan or apply your configuration. In HCP Terraform, you can enable health checks on a workspace to automatically and continuously execute checks defined in that workspace's configuration. Refer to [Continuous validation](/terraform/cloud-docs/workspaces/health#continuous-validation) for details.
 
-The `check` block is one of the Terraform configuration language's validation rules. Other validation rules run during other stages of a Terraform operation, and can block operations if they fail. However, the `check` block is the only validation rule that does not block operations, instead Terraform produces a warning and lets that operation continue. For information on other validation rules, refer to [Validate your configuration](/terraform/language/expressions/custom-conditions).
+The `check` block is one of Terraform's validation rules for verifying your configuration. Other validation rules run during other stages of a Terraform operation, and can block operations if they fail. The `check` block is the only validation rule that does not block operations if it fails, instead Terraform reports a warning and continues executing the current operation. For information on other validation rules, refer to [Validate your configuration](/terraform/language/expressions/custom-conditions).
 
 <!-- TODO: Fix link once have Validate your configuration page -->
 

From 92b1b129cbf2099cfbd4f045e6eeb24cd698b1ee Mon Sep 17 00:00:00 2001
From: rkoron007 <rkoron007@gmail.com>
Date: Thu, 20 Mar 2025 13:50:03 -0700
Subject: [PATCH 03/12] Take out checks and make a build-a-branch

---
 website/data/language-nav-data.json           |  14 +-
 website/docs/language/block/check.mdx         | 241 ------------------
 website/docs/language/{ => block}/moved.mdx   |   0
 .../docs/language/{ => block}/terraform.mdx   |   0
 website/docs/language/checks/index.mdx        | 121 +++++++++
 5 files changed, 130 insertions(+), 246 deletions(-)
 delete mode 100644 website/docs/language/block/check.mdx
 rename website/docs/language/{ => block}/moved.mdx (100%)
 rename website/docs/language/{ => block}/terraform.mdx (100%)
 create mode 100644 website/docs/language/checks/index.mdx

diff --git a/website/data/language-nav-data.json b/website/data/language-nav-data.json
index 779d2d7c8d38..7b7d642ab9d5 100644
--- a/website/data/language-nav-data.json
+++ b/website/data/language-nav-data.json
@@ -273,11 +273,11 @@
   },
   {
     "title": "Moved block",
-    "path": "moved"
+    "href": "/terraform/language/block/moved"
   },
   {
     "title": "Terraform block",
-    "path": "terraform"
+    "href": "/terraform/language/block/terraform"
   },
   {
     "title": "Backend block",
@@ -332,7 +332,7 @@
       }
     ]
   },
-
+  { "title": "Checks", "path": "checks" },
   {
       "title": "Import",
       "routes": [
@@ -1114,8 +1114,12 @@
     "title": "Configuration blocks",
     "routes": [
       {
-        "title": "check",
-        "path": "block/check"
+      "title": "Moved block",
+      "path": "block/moved"
+      },
+      {
+        "title": "Terraform block",
+        "path": "block/terraform"
       }
     ]
   },
diff --git a/website/docs/language/block/check.mdx b/website/docs/language/block/check.mdx
deleted file mode 100644
index eb3cbfcd0d07..000000000000
--- a/website/docs/language/block/check.mdx
+++ /dev/null
@@ -1,241 +0,0 @@
----
-page_title: Check block reference
-description: How to use the `check` block to validate infrastructure outside of the usual resource lifecycle.
----
-
-# `check` block
-
-Use the `check` block to validate your infrastructure outside of the typical resource lifecycle.
-
-The `check` block executes as the last step of plan or apply operation, after Terraform has planned or provisioned your infrastructure. When a `check` block's assertion fails, Terraform reports a warning and continues executing the current operation. 
-
-## Background
-
-Terraform evaluates `check` blocks locally whenever you plan or apply your configuration. In HCP Terraform, you can enable health checks on a workspace to automatically and continuously execute checks defined in that workspace's configuration. Refer to [Continuous validation](/terraform/cloud-docs/workspaces/health#continuous-validation) for details.
-
-The `check` block is one of Terraform's validation rules for verifying your configuration. Other validation rules run during other stages of a Terraform operation, and can block operations if they fail. The `check` block is the only validation rule that does not block operations if it fails, instead Terraform reports a warning and continues executing the current operation. For information on other validation rules, refer to [Validate your configuration](/terraform/language/expressions/custom-conditions).
-
-<!-- TODO: Fix link once have Validate your configuration page -->
-
-## Configuration model
-
-The `check` block supports the following arguments: 
-
-- [`check "<LABEL>"`](#check) &nbsp; block
-  - [`assert`](#assert) &nbsp; block (required)
-    - [`condition`](#assert) &nbsp; expression
-    - [`error_message`](#assert) &nbsp; string
-  - [`data "<TYPE>" "<LABEL>"`](#data) &nbsp; block
-    - [`PROVIDER_ARGUMENTS`](#provider_arguments) &nbsp; block | refer to your provider documentation
-    - [`depends_on`](#depends_on) &nbsp; list of references
-    - [`provider`](#provider) &nbsp; reference
-
-## Complete configuration
-
-All available arguments are defined in the following `check` block. There are no mutually exclusive arguments for a `check` block.
-
-```hcl
-check "<LABEL>" {
-  data "<TYPE>" "<LABEL>" {
-    <DATA_CONFIGURATION>
-  }
-
-  assert {
-    condition     = <EXPRESSION>
-    error_message = "<error message string>"
-  }
-}
-```
-
-A `check` block can contain [multiple assertions](#multiple-assertions). 
-
-## Specification
-
-A `check` block supports the following configuration. 
-
-### `check "<LABEL>"`
-
-While declaring a `check` block, you must add a unique label that starts with a letter or underscore and contains only letters, digits, underscores, and dashes.
-
-You can define the following blocks on a `check` block. A `check` block's assertion(s) are the conditions the check verifies.
-
-| Argument | Description | Type | Required |  
-| --- | --- | --- | --- |  
-| `assert` | The validation condition to evaluate. A check block contains one or more assertions. | Block | Required |  
-| `data` | One nested data source to use for validation. You can only reference this data source within its enclosing `check` block. | Block | Optional |
-
-### `assert`
-
-A `check` block must contain at least one `assert` block. Each `assert` block specifies a condition that Terraform evaluates after plan and apply operations. 
-
-```hcl
-check "unique_name" {
-  assert {
-    condition     = <expression-to-verify>
-    error_message = "The error message Terraform displays if the assert expression is false."
-  }
-}
-```
-
-For a check to pass, each `assert` block's `condition` must evaluate to `true`. The `condition` arguments within an `assert` block can reference nested data sources within the enclosing `check` block and any variables, resources, data sources, or module outputs within the current module.
-
-The `assert` block supports the following arguments:
-
-| Argument | Description | Type | Required |  
-| --- | --- | --- | --- |  
-| `condition` | Expression that Terraform evaluates. If the expression evaluates to `true`, then the `assert` block passes. | Expression | Required |  
-| `error_message` | Message to display if the condition evaluates to `false`. | String | Required |
-
-Refer to the [examples](#examples) to learn more about defining assertions within a `check` block.
-
-#### Summary
-
-- Data type: Block.   
-- Default: None.   
-- Required: Yes, each `check` block must contain at least one `assert` block.  
-- Example: [Declare multiple assertions](#multiple-assetions).
-
-### `data "<TYPE>" "<LABEL>"`
-
-You can optionally declare a `data` block within a `check` block to create a nested data source that lets you fetch information to reference in your conditions.
-
-```hcl
-check "unique_name" {
-  data "TYPE" "<LABEL>" {
-    <provider_specific_arguments>
-  }
-
-  assert { #... }
-}
-```
-
-You can only reference a nested data source within its enclosing `check` block. If a nested data source's provider raises errors, they are masked as warnings and do not prevent the Terraform operation from continuing.
-
-Unlike other [data sources](/terraform/language/data-sources), Terraform fetches the information for nested data sources as the final step of a plan or apply operation. You can use nested data sources to fetch information about your infrastructure after Terraform has applied the rest of your configuration. For example, you can use a nested `data` block to ping your website's API to ensure Terraform successfully applied and built your website's infrastructure.
-
-A nested `data` block requires a type and a label:
-
-- `TYPE`: Specifies the type of data source to use.  
-- `LABEL`: A unique name for this data source. Refer to [Resource naming](/terraform/language/style#resource-naming) for label recommendations.
-
-The arguments within a `data` block are provider-specific. Refer to the [registry documentation](https://registry.terraform.io/) for your specified provider for details. 
-
-### `depends_on`
-
-You can use the `depends_on` meta-argument in a nested data source if it depends on another resource to fetch information.
-
-```hcl
-check "unique_name" {
-  data "aws_ami" "web" {
-    <provider_specific_arguments>
-    depends_on = [<another_resource.name>]
-  }
-
-  assert { #... }
-}
-```
-
-We recommend adding the `depends_on` meta-argument if your nested data source depends on another resource without referencing that resource directly.
-
-For example, if you define a `check` that verifies that a website API returns `200`, that check will fail the first time Terraform runs your configuration because your website's infrastructure will not exist yet. You can set the `depends_on` argument to a resource such as the load balancer to ensure Terraform only runs the `check` once the website is up. When running an operation, Terraform evaluates the `check`, warns `known after apply` until that crucial piece of your website is ready, and continues the operation. 
-
-However, this strategy only works if your nested data source does not directly reference the resource it `depends_on`. Otherwise, anytime that resource changes, the `check` block warns `known after apply` until Terraform updates that resource, making your check potentially noisy and ineffective. Refer to the [example](#resource-dependency) for more details.
-
-The `depends_on` block is a meta-argument. Meta-arguments are built-in arguments that control how Terraform creates resources. Refer to [Meta-arguments](/terraform/language/meta-arguments/depends_on) for additional information. 
-
-<!-- TODO: Update meta-arguments concept link once we have the page -->
-
-### `provider`
-
-The `provider` argument instructs Terraform to use an alternate provider configuration to provision the nested data source. 
-
-```hcl
-check "unique_name" {
-  data "aws_ami" "web" {
-    <provider_specific_arguments>
-    provider = <provider>.<alias>
-  }
-
-  assert { #... }
-}
-```
-
-By default, Terraform automatically selects a provider based on the data source's type, but you can create multiple provider configurations and use a non-default configuration for specific resources. 
-
-The `provider` argument is a meta-argument, which is built into Terraform and controls the way that Terraform creates resources. Refer to [Meta-arguments](/terraform/language/meta-arguments/resource-provider) for additional information.
-
-<!-- TODO: Update meta-arguments concept link once we have the page -->
-
-#### Summary
-
-- Data type: Block.
-- Default: None.
-- Supported meta-arguments: `depends_on` and `provider`.
-- Example: [Resource dependency](#resource-dependency).
-
-## Examples
-
-The following examples demonstrate common use cases for `check` blocks.
-
-### Validate endpoint health
-
-The following example validates that an endpoint returns a healthy status code:
-
-```hcl
-check "health_check" {
-  data "http" "endpoint" {
-    url = "https://api.example.com/health"
-  }
-
-  assert {
-    condition     = data.http.endpoint.status_code == 200
-    error_message = "Health check failed: ${data.http.endpoint.url} returned ${data.http.endpoint.status_code}"
-  }
-}
-```
-
-This check uses a nested data source to check an endpoint's status code. If the endpoint returns a `200` then the check passes.  
-
-### Multiple assertions
-
-This example shows how to construct a check that uses multiple assertions:
-
-```hcl
-check "service_validation" {
-  data "aws_lb" "app" {
-    name = "application-lb"
-  }
-
-  assert {
-    condition     = data.aws_lb.app.enable_deletion_protection
-    error_message = "Load balancer must have deletion protection enabled"
-  }
-
-  assert {
-    condition     = length(data.aws_lb.app.security_groups) > 0
-    error_message = "Load balancer must have at least one security group"
-  }
-}
-```
-
-The check passes if the load balancer has at least one security group attached and has deletion protection enabled. 
-
-### Resource dependency
-
-This example shows how to use `depends_on` to ensure the check only runs after a resource is available:
-
-```hcl
-check "database_connection" {
-  data "postgresql_database" "app_db" {
-    name       = "application"
-    depends_on = [aws_db_instance.main]
-  }
-
-  assert {
-    condition     = data.postgresql_database.app_db.allow_connections
-    error_message = "Database is not accepting connections"
-  }
-}
-```
-
-The check warns `known after apply` during operations until Terraform creates the `aws_db_instance.main` database, meaning the check won't throw false warnings until Terraform creates that resource.
\ No newline at end of file
diff --git a/website/docs/language/moved.mdx b/website/docs/language/block/moved.mdx
similarity index 100%
rename from website/docs/language/moved.mdx
rename to website/docs/language/block/moved.mdx
diff --git a/website/docs/language/terraform.mdx b/website/docs/language/block/terraform.mdx
similarity index 100%
rename from website/docs/language/terraform.mdx
rename to website/docs/language/block/terraform.mdx
diff --git a/website/docs/language/checks/index.mdx b/website/docs/language/checks/index.mdx
new file mode 100644
index 000000000000..4f96bac93229
--- /dev/null
+++ b/website/docs/language/checks/index.mdx
@@ -0,0 +1,121 @@
+---
+page_title: Checks - Configuration Language
+description: >-
+  Check customized infrastructure requirements to provide ongoing and continuous verification.
+---
+
+# Checks
+
+-> **Note:** Check blocks are only available in Terraform v1.5.0 and later.
+
+The `check` block can validate your infrastructure outside the usual resource lifecycle. Check blocks address a gap between post-apply and functional validation of infrastructure.
+
+> **Hands-on:** Try the [Validate Infrastructure Using Checks](/terraform/tutorials/configuration-language/checks) tutorial.
+
+Check blocks allow you to define [custom conditions](/terraform/language/expressions/custom-conditions) that execute on every Terraform plan or apply operation without affecting the overall status of an operation. Check blocks execute as the last step of a plan or apply after Terraform has planned or provisioned your infrastructure.
+
+## Syntax
+
+You can declare a `check` block with a local name, zero-to-one scoped [data sources](#scoped-data-sources), and one-to-many [assertions](#assertions).
+
+The following example loads the Terraform website and validates that it returns the expected status code `200`.
+
+```hcl
+check "health_check" {
+  data "http" "terraform_io" {
+    url = "https://www.terraform.io"
+  }
+
+  assert {
+    condition = data.http.terraform_io.status_code == 200
+    error_message = "${data.http.terraform_io.url} returned an unhealthy status code"
+  }
+}
+```
+
+### Scoped data sources
+
+You can use any data source from any provider as a scoped data source within a `check` block.
+
+A `check` block can optionally contain a nested (a.k.a. scoped) data source. This `data` block behaves like an external [data source](/terraform/language/data-sources), except you can not reference it outside its enclosing `check` block. Additionally, if a scoped data source's provider raises any errors, they are masked as warnings and do not prevent Terraform from continuing operation execution.
+
+You can use a scoped data source to validate the status of a piece of infrastructure outside of the usual Terraform resource lifecycle. [In the above example](#checks-syntax), if the `terraform_io` data source fails to load, you receive a warning instead of a blocking error, which would occur if you declared this data source outside of a `check` block.
+
+#### Meta-Arguments
+
+Scoped data sources support the `depends_on` and `provider` [meta-arguments](/terraform/language/resources/syntax#meta-arguments). Scoped data sources do not support the `count` or`for_each` meta-arguments.
+
+##### `depends_on`
+
+The `depends_on` meta-argument can be particularly powerful when used within scoped data sources.
+
+The first time Terraform creates the _initial_ plan for our [previous example](#checks-syntax), the plan fails because Terraform has not applied its configuration yet. Meaning this test fails because Terraform must still create the resources to make this website exist. Therefore, the first time Terraform runs this check, it always throws a potentially distracting error message.
+
+You can fix this by adding [`depends_on`](/terraform/language/meta-arguments/depends_on) to your scoped data source, ensuring it depends on an essential piece of your site's infrastructure, such as the load balancer. The check returns  `known after apply` until that crucial piece of your website is ready. This strategy avoids producing unnecessary warnings during setup, and the check executes during subsequent plans and applies.
+
+One problem with this strategy is that if the resource your scoped data source `depends_on` changes, the check block returns `known after apply` until Terraform has updated that resource. Depending on your use case, this behavior could be acceptable or problematic.
+
+We recommend implementing the `depends_on` meta-argument if your scoped data source depends on the existence of another resource without referencing it directly.
+
+### Assertions
+
+Check blocks validate your custom assertions using `assert` blocks. Each `check` block must have at least one, but potentially many, `assert` blocks. Each `assert` block has a [`condition` attribute](/terraform/language/expressions/custom-conditions#condition-expressions) and an [`error_message` attribute](/terraform/language/expressions/custom-conditions#error-messages).
+
+Unlike other [custom conditions](/terraform/language/expressions/custom-conditions), assertions do not affect Terraform's execution of an operation. A failed assertion reports a warning without halting the ongoing operation. This contrasts with other custom conditions, such as a postcondition, where Terraform produces an error immediately, halting the operation and blocking the application or planning of future resources.
+
+Condition arguments within `assert` blocks can refer to scoped data sources within the enclosing `check` block and any variables, resources, data sources, or module outputs within the current module.
+
+[Learn more about assertions](/terraform/language/expressions/custom-conditions#checks-with-assertions).
+
+### Meta-Arguments
+
+Check blocks do not currently support [meta-arguments](/terraform/language/resources/syntax#meta-arguments). We are still collecting feedback on this feature, so if your use case would benefit from check blocks supporting meta-arguments, please [let us know](https://github.com/hashicorp/terraform/issues/new/choose).
+
+## Continuous validation in HCP Terraform
+
+HCP Terraform can automatically validate whether checks in a workspace’s configuration continue to pass after Terraform provisions new infrastructure. See [Continuous Validation](/terraform/cloud-docs/workspaces/health#continuous-validation) for details.
+
+## Choosing Checks or other Custom Conditions
+
+Check blocks offer the most _flexible_ validation solution within Terraform. You can reference outputs, variables, resources, and data sources within check assertions. You can also use checks to model every alternate [Custom Condition](/terraform/language/expressions/custom-conditions). However, that does not mean you should replace all your custom conditions with check blocks.
+
+There are major behavioral differences between check block assertions and other custom conditions, the main one being that check blocks do _not_ affect Terraform's execution of an operation. You can use this non-blocking behavior to decide the best type of validation for your use case.
+
+### Outputs and variables
+
+[Output postconditions](/terraform/language/expressions/custom-conditions#outputs) and [variable validations](/terraform/language/expressions/custom-conditions#input-variable-validation) both make assertions around inputs and outputs.
+
+This is one of the cases where you might want Terraform to block further execution. 
+
+For example, it is not helpful for Terraform to warn that an input variable is invalid after it applies an entire configuration with that input variable. In this case, a check block would warn of the invalid input variable _without_ interrupting the operation. A validation block for the same input variable would alert you of the invalid variable and halt the plan or apply operation.
+
+### Resource Preconditions and Postconditions
+
+The difference between [preconditions and postconditions](/terraform/language/expressions/custom-conditions#preconditions-and-postconditions) and check blocks is more nuanced.
+
+Preconditions are unique amongst the custom conditions in that they execute _before_ a resource change is applied or planned. [Choosing Between Preconditions and Postconditions](/terraform/language/expressions/custom-conditions#choosing-between-preconditions-and-postconditions) offers guidance on choosing between a precondition and a postcondition, and the same topics also apply to choosing between a precondition and a check block.
+
+You can often use postconditions interchangeably with check blocks to validate resources and data sources.
+
+For example, you can [rewrite the above `check` block example](#syntax) to use a postcondition instead. The below code uses a `postcondition` block to validate that the Terraform website returns the expected status code of `200`.
+
+```hcl
+data "http" "terraform_io" {
+  url = "https://www.terraform.io"
+
+  lifecycle {
+    postcondition {
+        condition = self.status_code == 200
+        error_message = "${self.url} returned an unhealthy status code"
+    }
+  }
+}
+```
+
+Both the `check` and `postcondition` block examples validate that the Terraform website returns a `200` status code during a plan or an apply operation. The difference between the two blocks is how each handles failure.
+
+If a `postcondition` block fails, it _blocks_ Terraform from executing the current operation. If a `check` block fails, it _does not_ block Terraform from executing an operation.
+
+If the above example's postcondition fails, it is impossible to recover from. Terraform blocks any future plan or apply operations if your postcondition is unsatisfied during the planning stage. This problem occurs because the postcondition does not directly depend on Terraform configuration, but instead on the complex interactions between multiple resources.
+
+We recommend using check blocks to validate the status of infrastructure as a whole. We only recommend using postconditions when you want a guarantee on a single resource based on that resource's configuration.
\ No newline at end of file

From 9915d5eb7ebef06082c99de8c10a0017f2687c2f Mon Sep 17 00:00:00 2001
From: Rose M Koron <32436232+rkoron007@users.noreply.github.com>
Date: Mon, 31 Mar 2025 14:44:58 -0700
Subject: [PATCH 04/12] Replacing the `check` block with the content type page
 (#36743)

---
 website/data/language-nav-data.json       |  12 +-
 website/docs/cli/test/index.mdx           |  10 +-
 website/docs/language/block/check.mdx     | 236 ++++++++++++++++++++++
 website/docs/language/block/terraform.mdx |  42 ++--
 website/docs/language/checks/index.mdx    | 121 -----------
 5 files changed, 270 insertions(+), 151 deletions(-)
 create mode 100644 website/docs/language/block/check.mdx
 delete mode 100644 website/docs/language/checks/index.mdx

diff --git a/website/data/language-nav-data.json b/website/data/language-nav-data.json
index 7b7d642ab9d5..4eb12b8fd460 100644
--- a/website/data/language-nav-data.json
+++ b/website/data/language-nav-data.json
@@ -6,9 +6,9 @@
     "path": "attr-as-blocks",
     "hidden": true
   },
-  { 
-    "title": "Style Guide", 
-    "path": "style" 
+  {
+    "title": "Style Guide",
+    "path": "style"
   },
   {
     "title": "Stacks",
@@ -332,7 +332,7 @@
       }
     ]
   },
-  { "title": "Checks", "path": "checks" },
+  { "title": "Check block", "href": "/terraform/language/block/check" },
   {
       "title": "Import",
       "routes": [
@@ -1113,6 +1113,10 @@
   {
     "title": "Configuration blocks",
     "routes": [
+      {
+      "title": "check",
+      "path": "block/check"
+      },
       {
       "title": "Moved block",
       "path": "block/moved"
diff --git a/website/docs/cli/test/index.mdx b/website/docs/cli/test/index.mdx
index 08177edce984..a3d6a99f561d 100644
--- a/website/docs/cli/test/index.mdx
+++ b/website/docs/cli/test/index.mdx
@@ -1,5 +1,5 @@
 ---
-page_title: Testing features in Terraform 
+page_title: Testing features in Terraform
 description: >-
   Learn about the terraform test command, which runs structured tests and validations for your configuration to ensure
   correctness in your infrastructure.
@@ -16,11 +16,11 @@ Terraform provides the following types of testing capabilities:
 1. Configuration and infrastructure validation as part of your regular Terraform operations. Refer to [Custom Conditions](/terraform/language/expressions/custom-conditions) and [Checks](/terraform/language/checks) to learn more about these types of testing capabilities.
 1. Traditional unit and integration testing on your configuration. Refer to the [`terraform test` command](/terraform/cli/commands/test) documentation to learn more about this testing capability.
 
-### Additional testing and validation features 
+### Additional testing and validation features
 
 - [Input Variable Validation](/terraform/language/expressions/custom-conditions#input-variable-validation)
 - [Pre and Post-conditions](/terraform/language/expressions/custom-conditions#preconditions-and-postconditions)
-- [Checks](/terraform/language/checks) 
+- [Checks](/terraform/language/block/check)
 
 ## How the `terraform test` command works
 
@@ -47,8 +47,8 @@ The Terraform `test` command also executes any validations within your configura
 
 You can write many validations as test assertions, but there are specific use cases for both.
 
-Validations are executed during Terraform plan and apply operations, and the Terraform `test` command also runs validations while executing tests. Therefore, use validations to validate aspects of your configuration that should always be true and could impact the valid execution of your infrastructure. 
+Validations are executed during Terraform plan and apply operations, and the Terraform `test` command also runs validations while executing tests. Therefore, use validations to validate aspects of your configuration that should always be true and could impact the valid execution of your infrastructure.
 
 Module authors should note that validations are executed and exposed to module users, so if they fail, ensure the failure messages are understandable and actionable.
 
-In contrast, Terraform only executes tests when you run `terraform test`. Use tests to assert the correctness of any logical operations or specific behavior within your configuration. For example, you can test that Terraform creates conditional resources based on an input by setting the input controlling those resources to a certain value then verifying the resources Terraform creates.
\ No newline at end of file
+In contrast, Terraform only executes tests when you run `terraform test`. Use tests to assert the correctness of any logical operations or specific behavior within your configuration. For example, you can test that Terraform creates conditional resources based on an input by setting the input controlling those resources to a certain value then verifying the resources Terraform creates.
diff --git a/website/docs/language/block/check.mdx b/website/docs/language/block/check.mdx
new file mode 100644
index 000000000000..8dfa26b5499b
--- /dev/null
+++ b/website/docs/language/block/check.mdx
@@ -0,0 +1,236 @@
+---
+page_title: Check block reference
+description: How to use the `check` block to validate infrastructure outside of the usual resource lifecycle.
+---
+
+# `check` block
+
+Use the `check` block to validate your infrastructure outside of the typical resource lifecycle.
+
+Terraform executes the `check` block as the last step of plan or apply operation, after Terraform has planned or provisioned your infrastructure. When a `check` block's assertion fails, Terraform reports a warning and continues executing the current operation.
+
+## Background
+
+Terraform evaluates `check` blocks locally whenever you plan or apply your configuration. In HCP Terraform, you can enable health checks on a workspace to automatically and continuously execute checks defined in that workspace's configuration. Refer to [Continuous validation](/terraform/cloud-docs/workspaces/health#continuous-validation) for details.
+
+The `check` block is one of the ways you can validate your configuration. Checks contain assertions, which specify the condition that Terraform is verifying during that check. Other validations run during other stages of a Terraform operation, and can block operations if they fail. The `check` block is the only validation that does not block operations, if a `check` block's assertion fails, Terraform reports a warning and continues executing the current operation.
+
+For information on all of the ways to validation configuration in Terraform, refer to [Validate your configuration](/terraform/language/mitigate-risk/validate#input-variable-validation).
+
+## Configuration model
+
+The `check` block supports the following arguments:
+
+- [`check "<LABEL>"`](#check) &nbsp; block
+   - [`assert`](#assert) &nbsp; block (required)
+      - [`condition`](#assert) &nbsp; expression
+      - [`error_message`](#assert) &nbsp; string
+   - [`data "<TYPE>" "<LABEL>"`](#data) &nbsp; block
+      - [`PROVIDER_ARGUMENTS`](#provider_arguments) &nbsp; block | refer to your provider documentation
+     - [`depends_on`](#depends_on) &nbsp; list of references
+     - [`provider`](#provider) &nbsp; reference
+
+## Complete configuration
+
+All available arguments are defined in the following `check` block. There are no mutually exclusive arguments for a `check` block.
+
+```hcl
+check "<LABEL>" {
+ data "<TYPE>" "<LABEL>" {
+   <DATA_CONFIGURATION>
+ }
+
+ assert {
+   condition     = <EXPRESSION>
+   error_message = "<error message string>"
+ }
+}
+```
+
+A `check` block can contain [multiple assertions](#multiple-assertions).
+
+## Specification
+
+A `check` block supports the following configuration.
+
+### `check "<LABEL>"`
+
+[Follow Terraform's resource naming rules](/terraform/language/style#resource-naming) when you declare a `check` block.
+
+You can define the following blocks on a `check` block.
+
+| Argument | Description | Type | Required |
+| --- | --- | --- | --- |
+| `assert` | The validation condition to evaluate. A `check` block contains one or more assertions. | Block | Required |
+| `data` | Specifies a data source to use for validation. You can only reference this data source within its parent `check` block. | Block | Optional |
+
+### `assert`
+
+A `check` block must contain at least one `assert` block. Each `assert` block specifies a condition that Terraform evaluates after plan and apply operations.
+
+```hcl
+check "unique_name" {
+ assert {
+   condition     = <expression-to-verify>
+   error_message = "The error message Terraform displays if the assert expression is false."
+ }
+}
+```
+
+For a check to pass, each `assert` block's `condition` must evaluate to `true`. The `condition` arguments within an `assert` block can reference [nested data sources](#data) within the parent `check` block and any variables, resources, data sources, or module outputs within the current module.
+
+The `assert` block supports the following arguments:
+
+| Argument | Description | Type | Required |
+| --- | --- | --- | --- |
+| `condition` | Expression that Terraform evaluates. If the expression evaluates to `true`, then the `assert` block passes. | Expression | Required |
+| `error_message` | Message to display if the condition evaluates to `false`. | String | Required |
+
+Refer to the [examples](#examples) to learn more about defining assertions within a `check` block.
+
+#### Summary
+
+- Data type: Block.
+- Default: None.
+- Required: Yes, each `check` block must contain at least one `assert` block.
+- Example: [Declare multiple assertions](#multiple-assetions).
+
+### `data "<TYPE>" "<LABEL>"`
+
+The `data` block fetches information that you can reference in expressions in the `assert` block's `condition` argument.
+
+```hcl
+check "unique_name" {
+ data "TYPE" "<LABEL>" {
+   <provider_specific_arguments>
+ }
+
+ assert { #... }
+}
+```
+
+Defining a `data` block in a `check` block is optional. You can only reference a nested data source within its parent `check` block. If a nested data source's provider raises errors, they are masked as warnings and do not prevent the Terraform operation from continuing.
+
+Unlike other [data sources](/terraform/language/data-sources), Terraform fetches the information for nested data sources as the final step of a plan or apply operation. You can use nested data sources to fetch information about your infrastructure after Terraform has applied the rest of your configuration. For example, you can use a nested `data` block to ping your website's API to ensure Terraform successfully applied and built your website's infrastructure.
+
+A nested `data` block requires a type and a label:
+
+- `TYPE`: Specifies the type of data source to use.
+- `LABEL`: A unique name for this data source. Refer to [Resource naming](/terraform/language/style#resource-naming) for label recommendations.
+
+The arguments within a `data` block are provider-specific. Refer to the [registry documentation](https://registry.terraform.io/) for your specified provider for details.
+
+### `depends_on`
+
+The `depends_on` argument specifies an upstream resource that the `data` block depends on. Terraform must complete all operations on the upstream resource before fetching information from the `data` block.
+
+```hcl
+check "unique_name" {
+ data "aws_ami" "web" {
+   <provider_specific_arguments>
+   depends_on = [<another_resource.name>]
+ }
+
+ assert { #... }
+}
+```
+
+We recommend adding the `depends_on` argument if your nested data source depends on another resource without referencing that resource directly.
+
+For example, if you define a `check` that verifies that a website API returns `200`, that check fails the first time Terraform runs your configuration because your website's infrastructure does not exist yet. You can set the `depends_on` argument to a resource, such as the load balancer, to ensure Terraform only runs the `check` once the website is up. When running an operation, Terraform evaluates the `check`, warns `known after apply` until that crucial piece of your website is ready, and continues the operation.
+
+However, this strategy only works when the `data` block does not directly reference the resource specified in the `depends_on` argument. Otherwise, anytime that resource changes, the `check` block warns `known after apply` until Terraform updates that resource, making your check potentially noisy and ineffective. Refer to the [example](#resource-dependency) for more details.
+
+The `depends_on` block is a meta-argument. Meta-arguments are built-in arguments that control how Terraform creates resources. Refer to [Meta-arguments](/terraform/language/meta-arguments/depends_on) for additional information.
+
+<!-- TODO: Update meta-arguments concept link once we have the page -->
+
+### `provider`
+
+The `provider` argument instructs Terraform to use an alternate provider configuration to provision the nested data source.
+
+```hcl
+check "unique_name" {
+ data "aws_ami" "web" {
+   <provider_specific_arguments>
+   provider = <provider>.<alias>
+ }
+
+ assert { #... }
+}
+```
+
+By default, Terraform automatically selects a provider based on the nested data source's type, but you can create multiple provider configurations and use a non-default configuration for specific data sources.
+
+The `provider` argument is a meta-argument, which is built into Terraform and controls the way that Terraform creates resources. Refer to [Meta-arguments](/terraform/language/meta-arguments/resource-provider) for additional information.
+
+<!-- TODO: Update meta-arguments concept link once we have the page -->
+
+#### Summary
+
+- Data type: Block.
+- Default: None.
+- Supported meta-arguments: `depends_on` and `provider`.
+- Example: [Resource dependency](#resource-dependency).
+
+## Examples
+
+The following examples demonstrate common use cases for `check` blocks.
+
+### Validate endpoint health
+
+In the following example, the `data` block calls an API endpoint to validate that the endpoint returns a healthy status code. If the endpoint does not return a `200` code, Terraform prints the error message specified in the `assert` block:
+
+```hcl
+check "health_check" {
+ data "http" "endpoint" {
+   url = "https://api.example.com/health"
+ }
+
+ assert {
+   condition     = data.http.endpoint.status_code == 200
+   error_message = "Health check failed: ${data.http.endpoint.url} returned ${data.http.endpoint.status_code}"
+ }
+}
+```
+
+### Multiple assertions
+
+In the following example, the `data` block queries the `aws_lb` resource. The `check` block asserts that the load balancer must have at least one security group attached and that deletion protection must be enabled:
+
+```hcl
+check "service_validation" {
+ data "aws_lb" "app" {
+   name = "application-lb"
+ }
+
+ assert {
+   condition     = data.aws_lb.app.enable_deletion_protection
+   error_message = "Load balancer must have deletion protection enabled"
+ }
+
+ assert {
+   condition     = length(data.aws_lb.app.security_groups) > 0
+   error_message = "Load balancer must have at least one security group"
+ }
+}
+```
+
+
+### Resource dependency
+
+In the following example, Terraform waits to run the check  until it creates the `aws_db_instance.main` database. Terraform prints `known after apply`, instead of printing false warnings, until it finishes creating the database:
+
+```hcl
+check "database_connection" {
+ data "postgresql_database" "app_db" {
+   name       = "application"
+   depends_on = [aws_db_instance.main]
+ }
+
+ assert {
+   condition     = data.postgresql_database.app_db.allow_connections
+   error_message = "Database is not accepting connections"
+ }
+}
+```
diff --git a/website/docs/language/block/terraform.mdx b/website/docs/language/block/terraform.mdx
index 704fb87c0373..70e0e87ccc12 100644
--- a/website/docs/language/block/terraform.mdx
+++ b/website/docs/language/block/terraform.mdx
@@ -13,7 +13,7 @@ This topic provides reference information about the `terraform` block. The `terr
 The `terraform` block supports the following arguments:
 
 - [`terraform`](#terraform)
-  - [`required_version`](#required_version): &nbsp string 
+  - [`required_version`](#required_version): &nbsp string
   - [`required_providers`](#required_providers): &nbsp block
     - [`<PROVIDER>`](#provider): &nbsp block
       - [`version`](#provider): &nbsp string
@@ -44,15 +44,15 @@ terraform {
       source = "<provider-address>"
     }
   }
-  provider_meta "<LABEL>" { 
-    # Shown for completeness but only used for specific cases     
+  provider_meta "<LABEL>" {
+    # Shown for completeness but only used for specific cases
   }
-  backend "<TYPE>" {        
-    # `backend` is mutually exclusive with `cloud` 
+  backend "<TYPE>" {
+    # `backend` is mutually exclusive with `cloud`
     "<ARGUMENTS>"
   }
-  cloud {                   
-    # `cloud` is mutually exclusive with `backend` 
+  cloud {
+    # `cloud` is mutually exclusive with `backend`
     organization = "<organization-name>"
     workspaces {
       tags = [ "<tag>" ]
@@ -76,7 +76,7 @@ Parent block that contains configurations that define Terraform behavior. You ca
 
 ### `required_version`
 
-Specifies which version of the Terraform CLI is allowed to run the configuration. 
+Specifies which version of the Terraform CLI is allowed to run the configuration.
 
 ```hcl
 terraform {
@@ -103,7 +103,7 @@ The `required_version` configuration applies only to the version of Terraform CL
 
 ### `required_providers`
 
-Specifies all provider plugins required to create and manage resources specified in the configuration. 
+Specifies all provider plugins required to create and manage resources specified in the configuration.
 
 ```hcl
 terraform {
@@ -131,7 +131,7 @@ terraform {
   required_providers {
     <PROVIDER> {
       version = "<version-constraint>"
-      source = "<address>"      
+      source = "<address>"
     }
   }
   # . . .
@@ -154,7 +154,7 @@ You can specify the following arguments:
 
 ### `provider_meta "<LABEL>"`
 
-Specifies metadata fields that a provider may expect. 
+Specifies metadata fields that a provider may expect.
 
 ```hcl
 terraform {
@@ -167,14 +167,14 @@ terraform {
 
 Individual modules can populate the metadata fields independently of any provider configuration. Refer to [Provider Metadata](/terraform/internals/provider-meta) for additional information.
 
-#### Summary 
+#### Summary
 
 - Data type: Block.
 - Default: None.
 
 ### `backend "<BACKEND_TYPE>"`
 
-Specifies a mechanism for storing Terraform state files. 
+Specifies a mechanism for storing Terraform state files.
 
 ```hcl
 terraform {
@@ -197,7 +197,7 @@ You cannot configure a `backend` block when the configuration also contains a [`
 
 ### `cloud`
 
-Specifies a set of attributes that allow the Terraform configuration to connect to either HCP Terraform or a Terraform Enterprise installation. 
+Specifies a set of attributes that allow the Terraform configuration to connect to either HCP Terraform or a Terraform Enterprise installation.
 
 ```hcl
 terraform {
@@ -224,7 +224,7 @@ The `cloud` block cannot refer to named values, such as input variables, locals,
 
 ### `organization`
 
-Specifies the name of the organization you want to connect to. 
+Specifies the name of the organization you want to connect to.
 
 ```hcl
 terraform {
@@ -245,7 +245,7 @@ Instead of hardcoding the organization as a string, you can alternatively use th
 
 ### `workspaces`
 
-Specifies metadata for matching workspaces in HCP Terraform. 
+Specifies metadata for matching workspaces in HCP Terraform.
 
 
 ```hcl
@@ -255,7 +255,7 @@ terraform {
       tags = [ "<workspace-tag>" ] # Mutually exclusive with `name`
       name = "<workspace-name>" # Mutually exclusive with `tags`
       project = "<project-name>"
-    }            
+    }
   }
   # . . .
 }
@@ -277,7 +277,7 @@ Terraform associates the configuration with workspaces managed in HCP Terraform
 
 ### `hostname`
 
-Specifies the hostname for a Terraform Enterprise deployment. 
+Specifies the hostname for a Terraform Enterprise deployment.
 
 ```hcl
 terraform {
@@ -299,7 +299,7 @@ Instead of hardcoding the hostname of the Terraform Enterprise deployment, you c
 
 ### `token`
 
-Specifies a token for authenticating with HCP Terraform. 
+Specifies a token for authenticating with HCP Terraform.
 
 ```hcl
 terraform {
@@ -321,7 +321,7 @@ We recommend omitting the token from the configuration and either using the [`te
 
 ### `experiments`
 
-Specifies a list of experimental feature names that you want to opt into. 
+Specifies a list of experimental feature names that you want to opt into.
 
 ```hcl
 terraform {
@@ -427,4 +427,4 @@ terraform {
     }
   }
 }
-```
\ No newline at end of file
+```
diff --git a/website/docs/language/checks/index.mdx b/website/docs/language/checks/index.mdx
deleted file mode 100644
index 4f96bac93229..000000000000
--- a/website/docs/language/checks/index.mdx
+++ /dev/null
@@ -1,121 +0,0 @@
----
-page_title: Checks - Configuration Language
-description: >-
-  Check customized infrastructure requirements to provide ongoing and continuous verification.
----
-
-# Checks
-
--> **Note:** Check blocks are only available in Terraform v1.5.0 and later.
-
-The `check` block can validate your infrastructure outside the usual resource lifecycle. Check blocks address a gap between post-apply and functional validation of infrastructure.
-
-> **Hands-on:** Try the [Validate Infrastructure Using Checks](/terraform/tutorials/configuration-language/checks) tutorial.
-
-Check blocks allow you to define [custom conditions](/terraform/language/expressions/custom-conditions) that execute on every Terraform plan or apply operation without affecting the overall status of an operation. Check blocks execute as the last step of a plan or apply after Terraform has planned or provisioned your infrastructure.
-
-## Syntax
-
-You can declare a `check` block with a local name, zero-to-one scoped [data sources](#scoped-data-sources), and one-to-many [assertions](#assertions).
-
-The following example loads the Terraform website and validates that it returns the expected status code `200`.
-
-```hcl
-check "health_check" {
-  data "http" "terraform_io" {
-    url = "https://www.terraform.io"
-  }
-
-  assert {
-    condition = data.http.terraform_io.status_code == 200
-    error_message = "${data.http.terraform_io.url} returned an unhealthy status code"
-  }
-}
-```
-
-### Scoped data sources
-
-You can use any data source from any provider as a scoped data source within a `check` block.
-
-A `check` block can optionally contain a nested (a.k.a. scoped) data source. This `data` block behaves like an external [data source](/terraform/language/data-sources), except you can not reference it outside its enclosing `check` block. Additionally, if a scoped data source's provider raises any errors, they are masked as warnings and do not prevent Terraform from continuing operation execution.
-
-You can use a scoped data source to validate the status of a piece of infrastructure outside of the usual Terraform resource lifecycle. [In the above example](#checks-syntax), if the `terraform_io` data source fails to load, you receive a warning instead of a blocking error, which would occur if you declared this data source outside of a `check` block.
-
-#### Meta-Arguments
-
-Scoped data sources support the `depends_on` and `provider` [meta-arguments](/terraform/language/resources/syntax#meta-arguments). Scoped data sources do not support the `count` or`for_each` meta-arguments.
-
-##### `depends_on`
-
-The `depends_on` meta-argument can be particularly powerful when used within scoped data sources.
-
-The first time Terraform creates the _initial_ plan for our [previous example](#checks-syntax), the plan fails because Terraform has not applied its configuration yet. Meaning this test fails because Terraform must still create the resources to make this website exist. Therefore, the first time Terraform runs this check, it always throws a potentially distracting error message.
-
-You can fix this by adding [`depends_on`](/terraform/language/meta-arguments/depends_on) to your scoped data source, ensuring it depends on an essential piece of your site's infrastructure, such as the load balancer. The check returns  `known after apply` until that crucial piece of your website is ready. This strategy avoids producing unnecessary warnings during setup, and the check executes during subsequent plans and applies.
-
-One problem with this strategy is that if the resource your scoped data source `depends_on` changes, the check block returns `known after apply` until Terraform has updated that resource. Depending on your use case, this behavior could be acceptable or problematic.
-
-We recommend implementing the `depends_on` meta-argument if your scoped data source depends on the existence of another resource without referencing it directly.
-
-### Assertions
-
-Check blocks validate your custom assertions using `assert` blocks. Each `check` block must have at least one, but potentially many, `assert` blocks. Each `assert` block has a [`condition` attribute](/terraform/language/expressions/custom-conditions#condition-expressions) and an [`error_message` attribute](/terraform/language/expressions/custom-conditions#error-messages).
-
-Unlike other [custom conditions](/terraform/language/expressions/custom-conditions), assertions do not affect Terraform's execution of an operation. A failed assertion reports a warning without halting the ongoing operation. This contrasts with other custom conditions, such as a postcondition, where Terraform produces an error immediately, halting the operation and blocking the application or planning of future resources.
-
-Condition arguments within `assert` blocks can refer to scoped data sources within the enclosing `check` block and any variables, resources, data sources, or module outputs within the current module.
-
-[Learn more about assertions](/terraform/language/expressions/custom-conditions#checks-with-assertions).
-
-### Meta-Arguments
-
-Check blocks do not currently support [meta-arguments](/terraform/language/resources/syntax#meta-arguments). We are still collecting feedback on this feature, so if your use case would benefit from check blocks supporting meta-arguments, please [let us know](https://github.com/hashicorp/terraform/issues/new/choose).
-
-## Continuous validation in HCP Terraform
-
-HCP Terraform can automatically validate whether checks in a workspace’s configuration continue to pass after Terraform provisions new infrastructure. See [Continuous Validation](/terraform/cloud-docs/workspaces/health#continuous-validation) for details.
-
-## Choosing Checks or other Custom Conditions
-
-Check blocks offer the most _flexible_ validation solution within Terraform. You can reference outputs, variables, resources, and data sources within check assertions. You can also use checks to model every alternate [Custom Condition](/terraform/language/expressions/custom-conditions). However, that does not mean you should replace all your custom conditions with check blocks.
-
-There are major behavioral differences between check block assertions and other custom conditions, the main one being that check blocks do _not_ affect Terraform's execution of an operation. You can use this non-blocking behavior to decide the best type of validation for your use case.
-
-### Outputs and variables
-
-[Output postconditions](/terraform/language/expressions/custom-conditions#outputs) and [variable validations](/terraform/language/expressions/custom-conditions#input-variable-validation) both make assertions around inputs and outputs.
-
-This is one of the cases where you might want Terraform to block further execution. 
-
-For example, it is not helpful for Terraform to warn that an input variable is invalid after it applies an entire configuration with that input variable. In this case, a check block would warn of the invalid input variable _without_ interrupting the operation. A validation block for the same input variable would alert you of the invalid variable and halt the plan or apply operation.
-
-### Resource Preconditions and Postconditions
-
-The difference between [preconditions and postconditions](/terraform/language/expressions/custom-conditions#preconditions-and-postconditions) and check blocks is more nuanced.
-
-Preconditions are unique amongst the custom conditions in that they execute _before_ a resource change is applied or planned. [Choosing Between Preconditions and Postconditions](/terraform/language/expressions/custom-conditions#choosing-between-preconditions-and-postconditions) offers guidance on choosing between a precondition and a postcondition, and the same topics also apply to choosing between a precondition and a check block.
-
-You can often use postconditions interchangeably with check blocks to validate resources and data sources.
-
-For example, you can [rewrite the above `check` block example](#syntax) to use a postcondition instead. The below code uses a `postcondition` block to validate that the Terraform website returns the expected status code of `200`.
-
-```hcl
-data "http" "terraform_io" {
-  url = "https://www.terraform.io"
-
-  lifecycle {
-    postcondition {
-        condition = self.status_code == 200
-        error_message = "${self.url} returned an unhealthy status code"
-    }
-  }
-}
-```
-
-Both the `check` and `postcondition` block examples validate that the Terraform website returns a `200` status code during a plan or an apply operation. The difference between the two blocks is how each handles failure.
-
-If a `postcondition` block fails, it _blocks_ Terraform from executing the current operation. If a `check` block fails, it _does not_ block Terraform from executing an operation.
-
-If the above example's postcondition fails, it is impossible to recover from. Terraform blocks any future plan or apply operations if your postcondition is unsatisfied during the planning stage. This problem occurs because the postcondition does not directly depend on Terraform configuration, but instead on the complex interactions between multiple resources.
-
-We recommend using check blocks to validate the status of infrastructure as a whole. We only recommend using postconditions when you want a guarantee on a single resource based on that resource's configuration.
\ No newline at end of file

From 9b271ad6356c0c3b957978a52a6b39b00d7e80ef Mon Sep 17 00:00:00 2001
From: Rose M Koron <32436232+rkoron007@users.noreply.github.com>
Date: Tue, 1 Apr 2025 16:17:46 -0700
Subject: [PATCH 05/12] Replace custom conditions article with Validate your
 configuration (#36793)

---
 website/data/language-nav-data.json           |  10 +-
 website/docs/cli/test/index.mdx               |  12 +-
 website/docs/language/data-sources/index.mdx  |   2 +-
 .../language/expressions/conditionals.mdx     | 134 +++++-
 .../expressions/custom-conditions.mdx         | 414 ------------------
 website/docs/language/functions/format.mdx    |   2 +-
 .../docs/language/functions/plantimestamp.mdx |   7 +-
 website/docs/language/functions/timecmp.mdx   |   5 +-
 .../language/meta-arguments/lifecycle.mdx     |   6 +-
 .../language/modules/develop/composition.mdx  |   2 +-
 website/docs/language/resources/syntax.mdx    |  40 +-
 .../language/test-and-validate/validate.mdx   | 245 +++++++++++
 website/docs/language/tests/index.mdx         |  14 +-
 website/docs/language/values/outputs.mdx      |   6 +-
 website/docs/language/values/variables.mdx    |   5 +-
 .../validation-order-of-operations-dark.jpg   | Bin 0 -> 37039 bytes
 .../validation-order-of-operations-light.jpg  | Bin 0 -> 36972 bytes
 17 files changed, 434 insertions(+), 470 deletions(-)
 delete mode 100644 website/docs/language/expressions/custom-conditions.mdx
 create mode 100644 website/docs/language/test-and-validate/validate.mdx
 create mode 100644 website/img/docs/validation-order-of-operations-dark.jpg
 create mode 100644 website/img/docs/validation-order-of-operations-light.jpg

diff --git a/website/data/language-nav-data.json b/website/data/language-nav-data.json
index 4eb12b8fd460..7a8885c2c398 100644
--- a/website/data/language-nav-data.json
+++ b/website/data/language-nav-data.json
@@ -333,6 +333,12 @@
     ]
   },
   { "title": "Check block", "href": "/terraform/language/block/check" },
+  {
+      "title": "Testing and Validation",
+      "routes": [
+       { "title": "Validate your configuration", "path": "test-and-validate/validate" }
+    ]
+  },
   {
       "title": "Import",
       "routes": [
@@ -375,10 +381,6 @@
         "title": "Dynamic Blocks",
         "path": "expressions/dynamic-blocks"
       },
-      {
-        "title": "Custom Conditions",
-        "path": "expressions/custom-conditions"
-      },
       {
         "title": "Type Constraints",
         "path": "expressions/type-constraints"
diff --git a/website/docs/cli/test/index.mdx b/website/docs/cli/test/index.mdx
index a3d6a99f561d..564e1ef22b7c 100644
--- a/website/docs/cli/test/index.mdx
+++ b/website/docs/cli/test/index.mdx
@@ -13,13 +13,13 @@ This topic provides an overview of the testing features in Terraform to help you
 
 Terraform provides the following types of testing capabilities:
 
-1. Configuration and infrastructure validation as part of your regular Terraform operations. Refer to [Custom Conditions](/terraform/language/expressions/custom-conditions) and [Checks](/terraform/language/checks) to learn more about these types of testing capabilities.
+1. Configuration and infrastructure validation as part of your regular Terraform operations. Refer to [Validate your configuration](/terraform/language/test-and-validate/validate) to learn more.
 1. Traditional unit and integration testing on your configuration. Refer to the [`terraform test` command](/terraform/cli/commands/test) documentation to learn more about this testing capability.
 
 ### Additional testing and validation features
 
-- [Input Variable Validation](/terraform/language/expressions/custom-conditions#input-variable-validation)
-- [Pre and Post-conditions](/terraform/language/expressions/custom-conditions#preconditions-and-postconditions)
+- [Input Variable Validation](/terraform/language/test-and-validate/validate#input-variable-validation)
+- [Preconditions and postconditions](/terraform/language/test-and-validate/validate#preconditions-and-postconditions)
 - [Checks](/terraform/language/block/check)
 
 ## How the `terraform test` command works
@@ -41,14 +41,14 @@ Terraform test files [have their own configuration syntax](/terraform/language/t
 
 Validations allow you to verify aspects of your configuration and infrastructure as it is applied and created. HCP Terraform also supports automated [continuous validation](/terraform/cloud-docs/workspaces/health#continuous-validation).
 
-The Terraform `test` command also executes any validations within your configuration as part of the tests it executes. For more information on the available validation, refer to [Checks](/terraform/language/checks) and [Custom Conditions](/terraform/language/expressions/custom-conditions).
+The Terraform `test` command also executes any validations within your configuration as part of the tests it executes. Refer to [Validate your configuration](/terraform/language/test-and-validate/validate) to learn more.
 
 ## Tests versus validations
 
 You can write many validations as test assertions, but there are specific use cases for both.
 
-Validations are executed during Terraform plan and apply operations, and the Terraform `test` command also runs validations while executing tests. Therefore, use validations to validate aspects of your configuration that should always be true and could impact the valid execution of your infrastructure.
+Terraform executes validations during plan and apply operations and when you run the `terraform test` command. Therefore, use validations to validate aspects of your configuration that should always be true and could impact the valid execution of your infrastructure.
 
 Module authors should note that validations are executed and exposed to module users, so if they fail, ensure the failure messages are understandable and actionable.
 
-In contrast, Terraform only executes tests when you run `terraform test`. Use tests to assert the correctness of any logical operations or specific behavior within your configuration. For example, you can test that Terraform creates conditional resources based on an input by setting the input controlling those resources to a certain value then verifying the resources Terraform creates.
+By contrast, Terraform only executes tests when you run `terraform test`. Use tests to assert the correctness of any logical operations or specific behavior within your configuration. For example, you can test that Terraform creates conditional resources based on an input by setting the input controlling those resources to a certain value then verifying the resources Terraform creates.
diff --git a/website/docs/language/data-sources/index.mdx b/website/docs/language/data-sources/index.mdx
index f8d65223953f..3c65b35e0fc0 100644
--- a/website/docs/language/data-sources/index.mdx
+++ b/website/docs/language/data-sources/index.mdx
@@ -149,7 +149,7 @@ data "aws_ami" "example" {
 
 Custom conditions can help capture assumptions, helping future maintainers understand the configuration design and intent. They also return useful information about errors earlier and in context, helping consumers more easily diagnose issues in their configurations.
 
-Refer to [Custom Condition Checks](/terraform/language/expressions/custom-conditions#preconditions-and-postconditions) for more details.
+Refer to [Validate your configuration](/terraform/language/test-and-validate/validate#preconditions-and-postconditions) for more details.
 
 
 ## Multiple Resource Instances
diff --git a/website/docs/language/expressions/conditionals.mdx b/website/docs/language/expressions/conditionals.mdx
index 28ccc148b354..db9de465c5c9 100644
--- a/website/docs/language/expressions/conditionals.mdx
+++ b/website/docs/language/expressions/conditionals.mdx
@@ -45,7 +45,7 @@ You can create conditions that produce custom error messages for several types o
 
 Custom conditions can help capture assumptions, helping future maintainers understand the configuration design and intent. They also return useful information about errors earlier and in context, helping consumers more easily diagnose issues in their configurations.
 
-Refer to [Custom Condition Checks](/terraform/language/expressions/custom-conditions#input-variable-validation) for details.
+Refer to [Validate your configuration](/terraform/language/test-and-validate/validate#input-variable-validation) for details.
 
 ## Result Types
 
@@ -78,3 +78,135 @@ a string.
 ```hcl
 var.example ? tostring(12) : "hello"
 ```
+
+## Examples
+
+You can use any of Terraform's built-in functions or language operators
+in a condition as long as the expression is valid and returns a boolean result. The following examples demonstrate language features that can help you write condition expressions.
+
+### Logical operator examples
+
+Use the logical operators `&&` (AND), `||` (OR), and `!` (NOT) to combine multiple conditions together.
+
+```hcl
+  condition = var.name != "" && lower(var.name) == var.name
+```
+
+You can also use arithmetic operators, for example `a + b`, equality operators, for example `a == b`, and comparison operators, for example `a < b`. Refer to [Arithmetic and Logical Operators](/terraform/language/expressions/operators) for details.
+
+### `contains` Function
+
+Use the [`contains` function](/terraform/language/functions/contains) to test whether a given value is one of a set of predefined valid values.
+
+```hcl
+  condition = contains(["STAGE", "PROD"], var.environment)
+```
+
+### `length` Function
+
+Use the [`length` function](/terraform/language/functions/length) to test a collection's length and require a non-empty list or map.
+
+```hcl
+  condition = length(var.items) != 0
+```
+
+Using the `length` function is more suitable than using `==` or `!=` when both operands potentially have exactly the same type, which is often ambiguous for empty collections.
+
+### `for` Expressions
+
+Use [`for` expressions](/terraform/language/expressions/for) in conjunction with the functions `alltrue` and `anytrue` to test whether a condition holds for all or for any elements of a collection.
+
+```hcl
+  condition = alltrue([
+    for v in var.instances : contains(["t2.micro", "m3.medium"], v.type)
+  ])
+```
+
+### `can` Function
+
+Use the [`can` function](/terraform/language/functions/can) to concisely use the validity of an expression as a condition. It returns `true` if its given expression evaluates successfully and `false` if it returns any error, so you can use various other functions that typically return errors as a part of your condition expressions.
+
+For example, you can use `can` with `regex` to test if a string matches a particular pattern because `regex` returns an error when given a non-matching string.
+
+```hcl
+  condition = can(regex("^[a-z]+$", var.name))
+```
+
+You can also use `can` with the type conversion functions to test whether a value is convertible to a type or type constraint.
+
+```hcl
+  # This remote output value must have a value that can
+  # be used as a string, which includes strings themselves
+  # but also allows numbers and boolean values.
+  condition = can(tostring(data.terraform_remote_state.example.outputs["name"]))
+```
+
+```hcl
+  # This remote output value must be convertible to a list
+  # type of with element type.
+  condition = can(tolist(data.terraform_remote_state.example.outputs["items"]))
+```
+
+You can also use `can` with attribute access or index operators to test whether a collection or structural value has a particular element or index.
+
+```hcl
+  # var.example must have an attribute named "foo"
+  condition = can(var.example.foo)
+```
+
+```hcl
+  # var.example must be a sequence with at least one element
+  condition = can(var.example[0])
+  # (although it would typically be clearer to write this as a
+  # test like length(var.example) > 0 to better represent the
+  # intent of the condition.)
+```
+
+### `self` Object
+
+Use the `self` object in postcondition blocks to refer to attributes of the instance under evaluation.
+
+```hcl
+resource "aws_instance" "example" {
+  instance_type = "t2.micro"
+  ami           = "ami-abc123"
+
+  lifecycle {
+    postcondition {
+      condition     = self.instance_state == "running"
+      error_message = "EC2 instance must be running."
+    }
+  }
+}
+```
+
+### `each` and `count` Objects
+
+In blocks where [`for_each`](/terraform/language/meta-arguments/for_each) or [`count`](/terraform/language/meta-arguments/count)  are set, use `each` and `count` objects to refer to other resources that are expanded in a chain.
+
+```hcl
+variable "vpc_cidrs" {
+  type = set(string)
+}
+
+data "aws_vpc" "example" {
+  for_each = var.vpc_cidrs
+
+  filter {
+    name   = "cidr"
+    values = [each.key]
+  }
+}
+
+resource "aws_internet_gateway" "example" {
+  for_each = data.aws_vpc.example
+  vpc_id = each.value.id
+
+  lifecycle {
+    precondition {
+      condition     = data.aws_vpc.example[each.key].state == "available"
+      error_message = "VPC ${each.key} must be available."
+    }
+  }
+}
+```
diff --git a/website/docs/language/expressions/custom-conditions.mdx b/website/docs/language/expressions/custom-conditions.mdx
deleted file mode 100644
index 6f658ad36ba4..000000000000
--- a/website/docs/language/expressions/custom-conditions.mdx
+++ /dev/null
@@ -1,414 +0,0 @@
----
-page_title: Custom Conditions - Configuration Language
-description: >-
-  Check custom requirements for variables, outputs, data sources, and resources and provide better error messages in context.
----
-
-# Custom Conditions
-
-You can create conditions that produce custom error messages for several types of objects in a configuration. For example, you can add a condition to an input variable that checks whether incoming image IDs are formatted properly. Custom conditions can capture assumptions, helping future maintainers understand the configuration design and intent. They also return useful information about errors earlier and in context, helping consumers more easily diagnose issues in their configurations.
-
-> **Hands On:** Try the [Validate Infrastructure Using Checks](/terraform/tutorials/configuration-language/checks) tutorial to learn how to use `check` blocks. Try the [Validate Modules with Custom Conditions](/terraform/tutorials/configuration-language/custom-conditions) tutorial to learn how to use other custom conditions.
-
-This page explains the following:
-  - Creating checks with [assertions](#checks-with-assertions) to verify your infrastructure as a whole (Terraform v1.5.0 and later)
-  - Creating [validation conditions](#input-variable-validation) for input variables (Terraform v0.13.0 and later)
-  - Creating [preconditions and postconditions](#preconditions-and-postconditions) for resources, data sources, and outputs (Terraform v1.2.0 and later)
-  - Writing effective [condition expressions](#condition-expressions) and [error messages](#error-messages)
-  - When Terraform [evaluates custom conditions](#conditions-checked-only-during-apply) during the plan and apply cycle
-
-## Selecting a Custom Condition for your use case
-
-Terraform's different custom conditions are best suited to various situations. Use the following broad guidelines to select the best custom condition for your use case:
-1. [Check blocks with assertions](#checks-with-assertions) validate your infrastructure as a whole. Additionally, check blocks do not prevent or block the overall execution of Terraform operations.
-1. [Validation conditions](#input-variable-validation) or [output postconditions](#preconditions-and-postconditions) can ensure your configuration's inputs and outputs meet specific requirements.
-1. Resource [preconditions and postconditions](#preconditions-and-postconditions) can validate that Terraform produces your configuration with predictable results.
-
-For more information on when to use certain custom conditions, see [Choosing Between Preconditions and Postconditions](#choosing-between-preconditions-and-postconditions) and [Choosing Checks or Other Custom Conditions](/terraform/language/checks#choosing-checks-or-other-custom-conditions).
-
-
-## Input Variable Validation
-
--> **Note:** Input variable validation is available in Terraform v0.13.0 and later. Before Terraform v1.9.0, validation rules can refer only to the variable being validated, and not to any other variables.
-
-Add one or more `validation` blocks within the `variable` block to specify custom conditions. Each validation requires a [`condition` argument](#condition-expressions), an expression that must use the value of the variable to return `true` if the value is valid, or `false` if it is invalid. The expression must not cause errors directly itself.
-
-If the condition evaluates to `false`, Terraform produces an [error message](#error-messages) that includes the result of the `error_message` expression. If you declare multiple validations, Terraform returns error messages for all failed conditions.
-
-The following example checks whether the AMI ID has valid syntax.
-
-```hcl
-variable "image_id" {
-  type        = string
-  description = "The id of the machine image (AMI) to use for the server."
-
-  validation {
-    condition     = length(var.image_id) > 4 && substr(var.image_id, 0, 4) == "ami-"
-    error_message = "The image_id value must be a valid AMI id, starting with \"ami-\"."
-  }
-}
-```
-
-If the failure of an expression determines the validation decision, use the [`can` function](/terraform/language/functions/can) as demonstrated in the following example.
-
-```hcl
-variable "image_id" {
-  type        = string
-  description = "The id of the machine image (AMI) to use for the server."
-
-  validation {
-    # regex(...) fails if it cannot find a match
-    condition     = can(regex("^ami-", var.image_id))
-    error_message = "The image_id value must be a valid AMI id, starting with \"ami-\"."
-  }
-}
-```
-
-
-## Preconditions and Postconditions
-
--> **Note:** Preconditions and postconditions are available in Terraform v1.2.0 and later.
-
-Use `precondition` and `postcondition` blocks to create custom rules for resources, data sources, and outputs.
-
-Terraform checks a precondition _before_ evaluating the object it is associated with and checks a postcondition _after_ evaluating the object. Terraform evaluates custom conditions as early as possible, but must defer conditions that depend on unknown values until the apply phase. Refer to [Conditions Checked Only During Apply](#conditions-checked-only-during-apply) for more details.
-
-### Usage
-
-Each precondition and postcondition requires a [`condition` argument](#condition-expressions). This is an expression that must return `true` if the conditition is fufilled or `false` if it is invalid. The expression can refer to any other objects in the same module, as long as the references do not create cyclic dependencies. Resource postconditions can also use the [`self` object](#self-object) to refer to attributes of each instance of the resource where they are configured.
-
-If the condition evaluates to `false`, Terraform will produce an [error message](#error-messages) that includes the result of the `error_message` expression. If you declare multiple preconditions or postconditions, Terraform returns error messages for all failed conditions.
-
-The following example uses a postcondition to detect if the caller accidentally provided an AMI intended for the wrong system component.
-
-```hcl
-data "aws_ami" "example" {
-  id = var.aws_ami_id
-
-  lifecycle {
-    # The AMI ID must refer to an existing AMI that has the tag "nomad-server".
-    postcondition {
-      condition     = self.tags["Component"] == "nomad-server"
-      error_message = "tags[\"Component\"] must be \"nomad-server\"."
-    }
-  }
-}
-```
-
-#### Resources and Data Sources
-
-The `lifecycle` block inside a `resource` or `data` block can include both `precondition` and `postcondition` blocks.
-
-- Terraform evaluates `precondition` blocks after evaluating existing `count` and `for_each` arguments. This lets Terraform evaluate the precondition separately for each instance and then make `each.key`, `count.index`, etc. available to those conditions. Terraform also evaluates preconditions before evaluating the resource's configuration arguments. Preconditions can take precedence over argument evaluation errors.
-- Terraform evaluates `postcondition` blocks after planning and applying changes to a managed resource, or after reading from a data source. Postcondition failures prevent changes to other resources that depend on the failing resource.
-
-In most cases, we do not recommend including both a `data` block and a `resource` block that both represent the same object in the same configuration. Doing so can prevent Terraform from understanding that the `data` block result can be affected by changes in the `resource` block. However, when you need to check a result of a `resource` block that the resource itself does not directly export, you can use a `data` block to check that object safely as long as you place the check as a direct `postcondition` of the `data` block. This tells Terraform that the `data` block is serving as a check of an object defined elsewhere, allowing Terraform to perform actions in the correct order.
-
-#### Outputs
-
-An `output` block can include a `precondition`  block.
-
-Preconditions can serve a symmetrical purpose to input variable `validation` blocks. Whereas input variable validation checks assumptions the module makes about its inputs, preconditions check guarantees that the module makes about its outputs. You can use preconditions to prevent Terraform from saving an invalid new output value in the state. You can also use them to preserve a valid output value from the previous apply, if applicable.
-
-Terraform evaluates output value preconditions before evaluating the `value` expression to finalize the result. Preconditions can take precedence over potential errors in the `value` expression.
-
-### Examples
-
-The following example shows use cases for preconditions and postconditions. The preconditions and postconditions declare the following assumptions and guarantees.
-
-- **The AMI ID must refer to an AMI that contains an operating system for the
-`x86_64` architecture.** The precondition would detect if the caller accidentally built an AMI for a different architecture, which may not be able to run the software this virtual machine is intended to host.
-
-- **The EC2 instance must be allocated a public DNS hostname.** In Amazon Web Services, EC2 instances are assigned public DNS hostnames only if they belong to a virtual network configured in a certain way. The postcondition would detect if the selected virtual network is not configured correctly, prompting the user to debug the network settings.
-
-- **The EC2 instance will have an encrypted root volume.** The postcondition ensures that the root volume is encrypted, even though the software running in this EC2 instance would probably still operate as expected on an unencrypted volume. This lets Terraform produce an error immediately, before any other components rely on the new EC2 instance.
-
-```hcl
-
-data "aws_ami" "example" {
-  owners = ["amazon"]
-
-  filter {
-    name   = "image-id"
-    values = ["ami-abc123"]
-  }
-}
-
-resource "aws_instance" "example" {
-  instance_type = "t3.micro"
-  ami           = data.aws_ami.example.id
-
-  lifecycle {
-    # The AMI ID must refer to an AMI that contains an operating system
-    # for the `x86_64` architecture.
-    precondition {
-      condition     = data.aws_ami.example.architecture == "x86_64"
-      error_message = "The selected AMI must be for the x86_64 architecture."
-    }
-
-    # The EC2 instance must be allocated a public DNS hostname.
-    postcondition {
-      condition     = self.public_dns != ""
-      error_message = "EC2 instance must be in a VPC that has public DNS hostnames enabled."
-    }
-  }
-}
-
-data "aws_ebs_volume" "example" {
-  # Use data resources that refer to other resources to
-  # load extra data that isn't directly exported by a resource.
-  #
-  # Read the details about the root storage volume for the EC2 instance
-  # declared by aws_instance.example, using the exported ID.
-
-  filter {
-    name = "volume-id"
-    values = [aws_instance.example.root_block_device[0].volume_id]
-  }
-
-  # Whenever a data resource is verifying the result of a managed resource
-  # declared in the same configuration, you MUST write the checks as
-  # postconditions of the data resource. This ensures Terraform will wait
-  # to read the data resource until after any changes to the managed resource
-  # have completed.
-  lifecycle {
-    # The EC2 instance will have an encrypted root volume.
-    postcondition {
-      condition     = self.encrypted
-      error_message = "The server's root volume is not encrypted."
-    }
-  }
-}
-
-output "api_base_url" {
-  value = "https://${aws_instance.example.private_dns}:8433/"
-}
-```
-
-### Choosing Between Preconditions and Postconditions
-
-You can often implement a validation check as either a postcondition of the resource producing the data or as a precondition of a resource or output value using the data. To decide which is most appropriate, consider whether the check is representing either an assumption or a guarantee.
-
-#### Use Preconditions for Assumptions
-
-An assumption is a condition that must be true in order for the configuration of a particular resource to be usable. For example, an `aws_instance` configuration can have the assumption that the given AMI will always be configured for the `x86_64` CPU architecture.
-
-We recommend using preconditions for assumptions, so that future maintainers can find them close to the other expressions that rely on that condition. This lets them understand more about what that resource is intended to allow.
-
-#### Use Postconditions for Guarantees
-
-A guarantee is a characteristic or behavior of an object that the rest of the configuration should be able to rely on. For example, an `aws_instance` configuration can have the guarantee that an EC2 instance will be running in a network that assigns it a private DNS record.
-
-We recommend using postconditions for guarantees, so that future maintainers can find them close to the resource configuration that is responsible for implementing those guarantees. This lets them more easily determine which behaviors they should preserve when changing the configuration.
-
-#### Additional Decision Factors
-
-You should also consider the following questions when creating preconditions and postconditions.
-
-- Which resource or output value would be most helpful to report in the error message? Terraform will always report errors in the location where the condition was declared.
-- Which approach is more convenient? If a particular resource has many dependencies that all make an assumption about that resource, it can be pragmatic to declare that once as a post-condition of the resource, rather than declaring it many times as preconditions on each of the dependencies.
-- Is it helpful to declare the same or similar conditions as both preconditions and postconditions? This can be useful if the postcondition is in a different module than the precondition because it lets the modules verify one another as they evolve independently.
-
-## Checks with Assertions
-
--> **Note:** Check blocks and their assertions are only available in Terraform v1.5.0 and later.
-
-[Check blocks](/terraform/language/checks) can validate your infrastructure outside the usual resource lifecycle. You can add custom conditions via `assert` blocks, which execute at the end of the plan and apply stages and produce warnings to notify you of problems within your infrastructure.
-
-You can add one or more `assert` blocks within a `check` block to verify custom conditions. Each assertion requires a [`condition` argument](#condition-expressions), a boolean expression that should return `true` if the intended assumption or guarantee is fulfilled or `false` if it does not. Your `condition` expression can refer to any resource, data source, or variable available to the surrounding `check` block.
-
-The following example uses a check block with an assertion to verify the Terraform website is healthy.
-
-```hcl
-check "health_check" {
-  data "http" "terraform_io" {
-    url = "https://www.terraform.io"
-  }
-
-  assert {
-    condition = data.http.terraform_io.status_code == 200
-    error_message = "${data.http.terraform_io.url} returned an unhealthy status code"
-  }
-}
-```
-
-If the condition evaluates to `false`, Terraform produces an [error message](#error-messages) that includes the result of the `error_message` expression. If you declare multiple assertions, Terraform returns error messages for all failed conditions.
-
-### Continuous Validation in HCP Terraform
-
-HCP Terraform can automatically check whether the checks in a workspace’s configuration continue to pass after Terraform provisions the infrastructure. For example, you can write a `check` to continuously monitor the validity of an API gateway certificate. Continuous validation alerts you when the condition fails, so you can update the certificate and avoid errors the next time you want to update your infrastructure. Refer to [Continuous Validation](/terraform/cloud-docs/workspaces/health#continuous-validation) in the HCP Terraform documentation for details.
-
-## Condition Expressions
-
-Check assertions, input variable validation, preconditions, and postconditions all require a `condition` argument. This is a boolean expression that should return `true` if the intended assumption or guarantee is fulfilled or `false` if it does not.
-
-You can use any of Terraform's built-in functions or language operators
-in a condition as long as the expression is valid and returns a boolean result. The following language features are particularly useful when writing condition expressions.
-
-### Logical Operators
-
-Use the logical operators `&&` (AND), `||` (OR), and `!` (NOT) to combine multiple conditions together.
-
-```hcl
-  condition = var.name != "" && lower(var.name) == var.name
-```
-
-You can also use arithmetic operators (e.g. `a + b`), equality operators (eg., `a == b`) and comparison operators (e.g., `a < b`). Refer to [Arithmetic and Logical Operators](/terraform/language/expressions/operators) for details.
-
-### `contains` Function
-
-Use the [`contains` function](/terraform/language/functions/contains) to test whether a given value is one of a set of predefined valid values.
-
-```hcl
-  condition = contains(["STAGE", "PROD"], var.environment)
-```
-
-### `length` Function
-
-Use the [`length` function](/terraform/language/functions/length) to test a collection's length and require a non-empty list or map.
-
-```hcl
-  condition = length(var.items) != 0
-```
-This is a better approach than directly comparing with another collection using `==` or `!=`. This is because the comparison operators can only return `true` if both operands have exactly the same type, which is often ambiguous for empty collections.
-
-### `for` Expressions
-
-Use [`for` expressions](/terraform/language/expressions/for) in conjunction with the functions `alltrue` and `anytrue` to test whether a condition holds for all or for any elements of a collection.
-
-```hcl
-  condition = alltrue([
-    for v in var.instances : contains(["t2.micro", "m3.medium"], v.type)
-  ])
-```
-
-### `can` Function
-
-Use the [`can` function](/terraform/language/functions/can) to concisely use the validity of an expression as a condition. It returns `true` if its given expression evaluates successfully and `false` if it returns any error, so you can use various other functions that typically return errors as a part of your condition expressions.
-
-For example, you can use `can` with `regex` to test if a string matches a particular pattern because `regex` returns an error when given a non-matching string.
-
-```hcl
-  condition = can(regex("^[a-z]+$", var.name))
-```
-
-You can also use `can` with the type conversion functions to test whether a value is convertible to a type or type constraint.
-
-```hcl
-  # This remote output value must have a value that can
-  # be used as a string, which includes strings themselves
-  # but also allows numbers and boolean values.
-  condition = can(tostring(data.terraform_remote_state.example.outputs["name"]))
-```
-
-```hcl
-  # This remote output value must be convertible to a list
-  # type of with element type.
-  condition = can(tolist(data.terraform_remote_state.example.outputs["items"]))
-```
-
-You can also use `can` with attribute access or index operators to test whether a collection or structural value has a particular element or index.
-
-```hcl
-  # var.example must have an attribute named "foo"
-  condition = can(var.example.foo)
-```
-
-```hcl
-  # var.example must be a sequence with at least one element
-  condition = can(var.example[0])
-  # (although it would typically be clearer to write this as a
-  # test like length(var.example) > 0 to better represent the
-  # intent of the condition.)
-```
-
-### `self` Object
-
-Use the `self` object in postcondition blocks to refer to attributes of the instance under evaluation.
-
-```hcl
-resource "aws_instance" "example" {
-  instance_type = "t2.micro"
-  ami           = "ami-abc123"
-
-  lifecycle {
-    postcondition {
-      condition     = self.instance_state == "running"
-      error_message = "EC2 instance must be running."
-    }
-  }
-}
-```
-
-### `each` and `count` Objects
-
-In blocks where [`for_each`](/terraform/language/meta-arguments/for_each) or [`count`](/terraform/language/meta-arguments/count)  are set, use `each` and `count` objects to refer to other resources that are expanded in a chain.
-
-```hcl
-variable "vpc_cidrs" {
-  type = set(string)
-}
-
-data "aws_vpc" "example" {
-  for_each = var.vpc_cidrs
-
-  filter {
-    name   = "cidr"
-    values = [each.key]
-  }
-}
-
-resource "aws_internet_gateway" "example" {
-  for_each = data.aws_vpc.example
-  vpc_id = each.value.id
-
-  lifecycle {
-    precondition {
-      condition     = data.aws_vpc.example[each.key].state == "available"
-      error_message = "VPC ${each.key} must be available."
-    }
-  }
-}
-```
-
-## Error Messages
-
-Input variable validations, preconditions, and postconditions all must include the `error_message` argument. This contains the text that Terraform will include as part of error messages when it detects an unmet condition.
-
-```
-Error: Resource postcondition failed
-
-  with data.aws_ami.example,
-  on ec2.tf line 19, in data "aws_ami" "example":
-  72:       condition     = self.tags["Component"] == "nomad-server"
-    |----------------
-    | self.tags["Component"] is "consul-server"
-
-The selected AMI must be tagged with the Component value "nomad-server".
-```
-
-The `error_message` argument can be any expression that evaluates to a string.
-This includes literal strings, heredocs, and template expressions. You can use the [`format` function](/terraform/language/functions/format) to convert items of `null`, `list`, or `map` types into a formatted string. Multi-line
-error messages are supported, and lines with leading whitespace will not be
-word wrapped.
-
-We recommend writing error messages as one or more full sentences in a
-style similar to Terraform's own error messages. Terraform will show the
-message alongside the name of the resource that detected the problem and any
-external values included in the condition expression.
-
-## Conditions Checked Only During Apply
-
-Terraform evaluates custom conditions as early as possible.
-
-Input variable validations can only refer to the variable value, so Terraform always evaluates them immediately. Check assertions, preconditions, and postconditions depend on Terraform evaluating whether the value(s) associated with the condition are known before or after applying the configuration.
-
-- **Known before apply:** Terraform checks the condition during the planning phase. For example, Terraform can know the value of an image ID during planning as long as it is not generated from another resource.
-- **Known after apply:** Terraform delays checking that condition until the apply phase. For example, AWS only assigns the root volume ID when it starts an EC2 instance, so Terraform cannot know this value until apply.
-
-During the apply phase, a failed _precondition_
-will prevent Terraform from implementing planned actions for the associated resource. However, a failed _postcondition_ will halt processing after Terraform has already implemented these actions. The failed postcondition prevents any further downstream actions that rely on the resource, but does not undo the actions Terraform has already taken.
-
-Terraform typically has less information during the initial creation of a
-full configuration than when applying subsequent changes. Therefore, Terraform may check conditions during apply for initial creation and then check them during planning for subsequent updates.
-
diff --git a/website/docs/language/functions/format.mdx b/website/docs/language/functions/format.mdx
index 0bf30208d508..70d40b70631e 100644
--- a/website/docs/language/functions/format.mdx
+++ b/website/docs/language/functions/format.mdx
@@ -41,7 +41,7 @@ We can specify an argument position number
 "/path/file.tf"
 ```
 
-The formatting verb `%#v` accepts a value of any type and presents it using JSON encoding, similar to jsonencode. This can be useful for describing the values given to a module in [custom condition check](/terraform/language/expressions/custom-conditions#error-messages) error messages.
+The formatting verb `%#v` accepts a value of any type and presents it using JSON encoding. This can be useful for describing the values given to a module in error messages while [validating your configuration](/terraform/language/test-and-validate/validate#error-messages).
 
 ```
 > format("%#v", "hello")
diff --git a/website/docs/language/functions/plantimestamp.mdx b/website/docs/language/functions/plantimestamp.mdx
index 7b3a41e0d030..c76e9c399975 100644
--- a/website/docs/language/functions/plantimestamp.mdx
+++ b/website/docs/language/functions/plantimestamp.mdx
@@ -16,9 +16,8 @@ strings using [RFC 3339](https://tools.ietf.org/html/rfc3339)
 "Date and Time format" syntax, and so `plantimestamp` returns a string
 in this format.
 
-The result of this function will change for every plan operation. It is intended
-for use within [Custom Conditions](/terraform/language/expressions/custom-conditions)
-as a way to validate time sensitive resources such as TLS certificates.
+The result of this function changes during every plan operation. You can use `plantimestamp` to validate time sensitive resources, such as TLS certificates,
+while [Validating your configuration](/terraform/language/test-and-validate/validate).
 
 There are circumstances, such as during a Terraform [Refresh-only](/terraform/cli/commands/plan#planning-modes) plan, where
 the value for this function will be recomputed but not propagated to resources
@@ -51,4 +50,4 @@ check "terraform_io_certificate" {
 ## Related Functions
 
 * [`timestamp`](/terraform/language/functions/timestamp) returns the current timestamp when it is evaluated
-during the apply step.
\ No newline at end of file
+during the apply step.
diff --git a/website/docs/language/functions/timecmp.mdx b/website/docs/language/functions/timecmp.mdx
index 2c078a9b4e12..0d21b3210f43 100644
--- a/website/docs/language/functions/timecmp.mdx
+++ b/website/docs/language/functions/timecmp.mdx
@@ -43,9 +43,8 @@ both be strings conforming to this syntax.
 0
 ```
 
-`timecmp` can be particularly useful in defining
-[custom condition checks](/terraform/language/expressions/custom-conditions) that
-involve a specified timestamp being within a particular range. For example,
+The `timecmp` function is suitable for validations that verify that a specified timestamp is within a particular range.
+Refer to [Validating your configuration](/terraform/language/test-and-validate/validate) to learn more about validating your configuration. For example,
 the following resource postcondition would raise an error if a TLS certificate
 (or other expiring object) expires sooner than 30 days from the time of
 the "apply" step:
diff --git a/website/docs/language/meta-arguments/lifecycle.mdx b/website/docs/language/meta-arguments/lifecycle.mdx
index b62bb5131fe5..3ae9fa4b7773 100644
--- a/website/docs/language/meta-arguments/lifecycle.mdx
+++ b/website/docs/language/meta-arguments/lifecycle.mdx
@@ -50,12 +50,12 @@ The arguments available within a `lifecycle` block are `create_before_destroy`,
   type before using `create_before_destroy` with it.
 
   Note that Terraform propagates and applies the `create_before_destroy` meta-attribute
-  behaviour to all resource dependencies. For example, if `create_before_destroy` is enabled on resource A but not on resource B, but resource A is dependent on resource B, then Terraform enables `create_before_destroy` for resource B 
+  behaviour to all resource dependencies. For example, if `create_before_destroy` is enabled on resource A but not on resource B, but resource A is dependent on resource B, then Terraform enables `create_before_destroy` for resource B
   implicitly by default and stores it to the state file. You cannot override `create_before_destroy`
   to `false` on resource B because that would imply dependency cycles in the graph.
 
   Destroy provisioners of this resource do not run if `create_before_destroy`
-  is set to `true`. 
+  is set to `true`.
 
 * `prevent_destroy` (bool) - This meta-argument, when set to `true`, will
   cause Terraform to reject with an error any plan that would destroy the
@@ -173,7 +173,7 @@ resource "aws_instance" "example" {
 
 Custom conditions can help capture assumptions, helping future maintainers understand the configuration design and intent. They also return useful information about errors earlier and in context, helping consumers more easily diagnose issues in their configurations.
 
-Refer to [Custom Conditions](/terraform/language/expressions/custom-conditions#preconditions-and-postconditions) for more details.
+Refer to [Validate your configuration](/terraform/language/test-and-validate/validate#preconditions-and-postconditions#preconditions-and-postconditions) to learn more.
 
 ## Literal Values Only
 
diff --git a/website/docs/language/modules/develop/composition.mdx b/website/docs/language/modules/develop/composition.mdx
index d50679f41135..3b753038063b 100644
--- a/website/docs/language/modules/develop/composition.mdx
+++ b/website/docs/language/modules/develop/composition.mdx
@@ -193,7 +193,7 @@ Every module has implicit assumptions and guarantees that define what data it ex
 - **Assumption:** A condition that must be true in order for the configuration of a particular resource to be usable. For example, an `aws_instance` configuration can have the assumption that the given AMI will always be configured for the `x86_64` CPU architecture.
 - **Guarantee:** A characteristic or behavior of an object that the rest of the configuration should be able to rely on. For example, an `aws_instance` configuration can have the guarantee that an EC2 instance will be running in a network that assigns it a private DNS record.
 
-We recommend using [custom conditions](/terraform/language/expressions/custom-conditions) to help capture and test for assumptions and guarantees. This helps future maintainers understand the configuration design and intent. Custom conditions also return useful information about errors earlier and in context, helping consumers more easily diagnose issues in their configurations.
+We recommend [validating your configuration](/terraform/language/test-and-validate/validate) to help capture and test for assumptions and guarantees. This helps future maintainers understand the configuration design and intent. Configuration validation returns useful information about errors earlier and in context, helping consumers more easily diagnose issues in their configurations.
 
 The following examples creates a precondition that checks whether the EC2 instance has an encrypted root volume.
 
diff --git a/website/docs/language/resources/syntax.mdx b/website/docs/language/resources/syntax.mdx
index 9cdf9b14105a..83a51f5a0811 100644
--- a/website/docs/language/resources/syntax.mdx
+++ b/website/docs/language/resources/syntax.mdx
@@ -20,8 +20,8 @@ For information about how Terraform manages resources after applying a configura
 
 ## Resource Syntax
 
-A `resource` block declares a resource of a specific type 
-with a specific local name. Terraform uses the name when referring to the resource 
+A `resource` block declares a resource of a specific type
+with a specific local name. Terraform uses the name when referring to the resource
 in the same module, but it has no meaning outside that module's scope.
 
 In the following example,  the `aws_instance` resource type is named `web`. The resource type and name must be unique within a module because they serve as an identifier for a given resource.
@@ -35,15 +35,15 @@ resource "aws_instance" "web" {
 
 Within the block body (between `{` and `}`) are the configuration arguments
 for the resource itself. The arguments often depend on the
-resource type. In this example, both `ami` and `instance_type` are special 
+resource type. In this example, both `ami` and `instance_type` are special
 arguments for [the `aws_instance` resource type](https://registry.terraform.io/providers/hashicorp/aws/latest/docs/resources/instance).
 
 -> **Note:** Resource names must start with a letter or underscore, and may
 contain only letters, digits, underscores, and dashes.
 
-Resource declarations can include more advanced features, such as single 
+Resource declarations can include more advanced features, such as single
 resource declarations that produce multiple similar remote objects, but only
-a small subset is required for initial use. 
+a small subset is required for initial use.
 
 ## Resource Types
 
@@ -53,24 +53,24 @@ attributes the resource supports.
 
 ### Providers
 
-A [provider](/terraform/language/providers/requirements) is a plugin for Terraform 
+A [provider](/terraform/language/providers/requirements) is a plugin for Terraform
 that offers a collection of resource types. Each resource type is implemented by a provider. A
 provider provides resources to manage a single cloud or on-premises
-infrastructure platform. Providers are distributed separately from Terraform, 
+infrastructure platform. Providers are distributed separately from Terraform,
 but Terraform can automatically install most providers when initializing
 a working directory.
 
-To manage resources, a Terraform module must specify the required providers. Refer to 
+To manage resources, a Terraform module must specify the required providers. Refer to
 [Provider Requirements](/terraform/language/providers/requirements) for additional information.
 
-Most providers need some configuration to access their remote API, 
-which is provided by the root module. Refer to 
+Most providers need some configuration to access their remote API,
+which is provided by the root module. Refer to
 [Provider Configuration](/terraform/language/providers/configuration) for additional information.
 
-Based on a resource type's name, Terraform can usually determine which provider to use. 
+Based on a resource type's name, Terraform can usually determine which provider to use.
 By convention, resource type names start with their provider's preferred local name.
-When using multiple configurations of a provider or non-preferred local provider names, 
-you must use [the `provider` meta-argument](/terraform/language/meta-arguments/resource-provider) 
+When using multiple configurations of a provider or non-preferred local provider names,
+you must use [the `provider` meta-argument](/terraform/language/meta-arguments/resource-provider)
 to manually choose a provider configuration.
 
 ### Resource Arguments
@@ -84,15 +84,15 @@ The values for resource arguments can make full use of
 language features.
 
 [Meta-arguments](#meta-arguments) are defined by Terraform
-and apply across all resource types. 
+and apply across all resource types.
 
 ### Documentation for Resource Types
 
 Every Terraform provider has its own documentation, describing its resource
 types and their arguments.
 
-Some provider documentation is still part of Terraform's core documentation, 
-but the [Terraform Registry](https://registry.terraform.io/browse/providers) 
+Some provider documentation is still part of Terraform's core documentation,
+but the [Terraform Registry](https://registry.terraform.io/browse/providers)
 is the main home for all publicly available provider docs.
 
 When viewing a provider's page on the Terraform
@@ -176,10 +176,10 @@ resource "aws_instance" "example" {
 }
 ```
 
-[Custom condition checks](/terraform/language/expressions/custom-conditions#preconditions-and-postconditions) 
-can help capture assumptions so that future maintainers 
-understand the configuration design and intent. They also return useful 
-information about errors earlier and in context, helping consumers to diagnose 
+[Custom condition checks](/terraform/language/expressions/custom-conditions#preconditions-and-postconditions)
+can help capture assumptions so that future maintainers
+understand the configuration design and intent. They also return useful
+information about errors earlier and in context, helping consumers to diagnose
 issues in their configuration.
 
 ## Operation Timeouts
diff --git a/website/docs/language/test-and-validate/validate.mdx b/website/docs/language/test-and-validate/validate.mdx
new file mode 100644
index 000000000000..484250b366bc
--- /dev/null
+++ b/website/docs/language/test-and-validate/validate.mdx
@@ -0,0 +1,245 @@
+---
+page_title: Validate your infrastructure in Terraform’s configuration language
+description: >-
+  Configuration-level validation lets you enforce rules, validate resources, and detect errors as part of your infrastructure provisioning process.
+---
+
+# Validate your configuration
+
+Validate your configuration to improve your module consumer's troubleshooting, make your runs more predictable, and help your maintainers understand your configuration's intent.
+
+## Introduction
+
+Validation helps you verify that your Terraform configuration works as you intend. Using different types of validation you can:
+
+- Verify input variables meet specific requirements.
+- Prevent incorrect outputs from writing to your state.
+- Ensure resources and data sources are configured correctly after Terraform applies them.
+- Verify the broader behavior of your infrastructure.
+- Document assumptions about your infrastructure.
+- Use HCP Terraform to regularly verify your infrastructure.
+
+When a validation fails, Terraform provides context that you can use in your error messages to help users understand and fix their issue. Terraform evaluates different ways of validation at [different stages of Terraform's execution cycle](#order-of-validation), and they can either block further operation execution or continue execution with warnings.
+
+For authors, adding validation to your configuration enforces your module's standards and requirements, helping module consumers understand and use your configuration.
+
+## Requirements
+
+- Terraform v0.13.0 or later for [input variable validation](#input-variable-validation)
+- Terraform v1.2.0 or later for [preconditions and postconditions](#preconditions-and-postconditions)
+- Terraform v1.5.0 or later for [`check` blocks](#checks)
+
+## Choose a validation for your use case
+
+> **Hands On:** Try the [Validate Modules with Custom Conditions](/terraform/tutorials/configuration-language/custom-conditions) tutorial to learn how to use variable validation, preconditions, and postconditions. Try the [Validate Infrastructure Using Checks](/terraform/tutorials/configuration-language/checks) tutorial to learn how to use `check` blocks.
+
+Terraform offers several ways of validating configuration:
+
+* Input variable validations verify your configuration's parameters when Terraform creates a plan.
+* Preconditions ensure individual resources, data sources, and outputs meet your requirements before Terraform tries to create them.
+* Postconditions verifies that Terraform produced your resources and data sources with the expected and desired settings.
+* Checks let you validate that your resources work as expected without blocking Terraform operations based on the check's result.
+
+Validating your configuration is flexible, and you can often use different kinds of validation to achieve the same result. When choosing a way of validating, consider whether or not you want the validation to block your operations, and during which phase of the Terraform workflow it should run.
+
+### Input variable validation
+
+Use input variable validation to perform the following tasks:
+- Verify input variables meet specific format requirements.
+- Verify input values fall within acceptable ranges.
+- Prevent Terraform operations if a variable is misconfigured.
+
+For example, you can validate whether a variable value has valid AMI ID syntax.
+
+```hcl
+variable "image_id" {
+  type        = string
+  description = "The id of the machine image (AMI) to use for the server."
+
+  validation {
+    condition     = length(var.image_id) > 4 && substr(var.image_id, 0, 4) == "ami-"
+    error_message = "The image_id value must be a valid AMI id, starting with \"ami-\"."
+  }
+}
+```
+
+If you set the value of the `image_id` variable to a string without AMI ID syntax, the condition evaluates to `false`. When a variable validation fails, Terraform errors, displays the configured `error_message`, and stops the operation from proceeding. While provider APIs often error on these same validations, this helps your users avoid the error and issues a helpful error message. You can also use these validations to enforce your organization's design decisions, such as naming conventions.
+
+To learn more about variable validations, refer to the [input variable block](/terraform/language/values/variables).
+
+### Preconditions and postconditions
+
+Use `precondition` blocks when you want to verify your configuration's assumptions for resources, data sources, and outputs before Terraform creates them. Use `postcondition` blocks to validate the guarantees your resources and data sources must meet for your configuration to run.
+
+#### Preconditions
+
+Terraform evaluates preconditions on resources, data sources, and outputs when Terraform creates a plan. Preconditions take precedence over any argument errors raised by providers on incorrectly configured resources, data sources, and outputs.
+
+The following example uses a precondition to verify that the AMI configured for an`aws_instance` uses the `x86_64` CPU architecture.
+
+```hcl
+resource "aws_instance" "example" {
+  instance_type = "t3.micro"
+  ami           = data.aws_ami.example.id
+
+  lifecycle {
+    # The AMI ID must refer to an AMI that contains an operating system
+    # for the `x86_64` architecture.
+    precondition {
+      condition     = data.aws_ami.example.architecture == "x86_64"
+      error_message = "The selected AMI must be for the x86_64 architecture."
+    }
+  }
+}
+```
+
+The precondition detects if the caller accidentally selected an AMI for a different architecture, which may not be able to run the software this instance hosts. Terraform evaluates the precondition while it builds its plan, and if the precondition fails Terraform throws an error with the `error_message` argument and stops the current operation. Refer to the [resource configuration reference](/terraform/language/block/resource) for more examples of using a precondition block.
+
+An `output` block can also include a precondition to verify a module's output. Use preconditions on outputs to validate that your output values meets your requirements before Terraform exposes them or stores their values in state.
+
+For example, you can use a precondition to ensure a server's security group has at least one ingress rule to allow traffic on ports `80` or `443`:
+
+```hcl
+output "instance_public_ip" {
+  value = aws_instance.web.public_ip
+
+  precondition {
+    condition     = length([for rule in aws_security_group.web.ingress : rule if rule.to_port == 80 || rule.to_port == 443]) > 0
+    error_message = "Security group must allow HTTP (port 80) or HTTPS (port 443) traffic."
+  }
+}
+```
+
+If the `precondition` fails, Terraform throws an error with the `error_message` and stops the current operation. Refer to the [`output` block reference](/terraform/language/values/outputs) for more details.
+
+#### Postconditions
+
+Terraform evaluates `postcondition` blocks after planning and applying changes to a resource, or after reading from a data source.
+
+For example, you can use a `postcondition` to detect if a user accidentally provided an AMI intended for the wrong system component.
+
+```hcl
+data "aws_ami" "example" {
+  id = var.aws_ami_id
+
+  lifecycle {
+    # The AMI ID must refer to an existing AMI that has the tag "nomad-server".
+    postcondition {
+      condition     = self.tags["Component"] == "nomad-server"
+      error_message = "tags[\"Component\"] must be \"nomad-server\"."
+    }
+  }
+}
+```
+
+Unless the component has the `"nomad-server"` tag, the postcondition fails, which prevents using the incorrect AMI to provision a server. If the postcondition fails, Terraform throws an error with the `error_message` argument and stops the current operation.
+
+Adding postconditions can prevent cascading changes to other dependent resources. Refer to the [`resource` configuration reference](/terraform/language/resources/syntax) for more examples of using a `postcondition` block.
+
+Postconditions can serve as static guardrails to enforce mandatory configuration aspects on your `data` and `resource` blocks. For verifying infrastructure dynamically against external or changing conditions, we recommend using the `check` blocks, which run as the final step of a Terraform operation after postconditions. Learn more about the [`check` block](#checks).
+
+#### Choose between a precondition or postcondition
+
+You can often implement similar verification with different kinds of validation to achieve the same result. For example, you could add a postcondition on a resource that produces data, or add a precondition to a resource or output that references that same data. To decide between a precondition or a postcondition, consider whether the rule you are setting represents an assumption you need to make about the configuration, or a guarantee on the resulting resource, and when it should run.
+
+Use preconditions for assumptions that you want to verify before Terraform creates the target block. For example, you may want to verify that the AMI selected for an `aws_instance` has x86_64 CPU architecture before trying to create the instance. Using preconditions for assumptions helps future maintainers understand the values a resource, output, or data source should allow.
+
+Use postconditions for guarantees that you need to verify after Terraform creates the resource or reads from the data source. For example, you may want to ensure that an `aws_instance` is launched in a network that assigns it a private DNS record. Use postconditions for guarantees to help future maintainers understand which behaviors they must preserve when changing configuration.
+
+Use the following considerations to help you decide between preconditions and postconditions:
+- Determine which block would most clearly report error messages. For example, if a resource has many dependencies, it can be pragmatic to declare one postcondition on that resource rather than preconditions on each dependency.
+- Determine whether the precondition and postcondition should you declare the same conditions. If your postcondition is in a different module from your precondition, it can be beneficial to have both, because each module verifies one another as each evolves independently.
+
+### Checks
+
+> **Hands On:** Try the [Validate Infrastructure Using Checks](/terraform/tutorials/configuration-language/checks) tutorial to learn how to use `check` blocks.
+
+Use the `check` block to validate your infrastructure outside of the typical resource lifecycle.
+
+The `check` block executes as the last step of plan or apply operation, after Terraform has planned or provisioned your infrastructure. When a `check` block's assertion fails, Terraform reports a warning and continues executing the current operation.
+
+Use `check` blocks to complete the following tasks:
+- Validate resources, data sources, variables, or outputs in your configuration.
+- Validate the behavior of your infrastructure as a whole.
+- Verify infrastructure configuration without blocking operations.
+- Perform [continuous validation in HCP Terraform](#continuous-validation-in-hcp-terraform).
+
+The following example uses a `check` block to verify the Terraform website is healthy.
+
+```hcl
+check "health_check" {
+  data "http" "terraform_io" {
+    url = "https://www.terraform.io"
+  }
+
+  assert {
+    condition = data.http.terraform_io.status_code == 200
+    error_message = "${data.http.terraform_io.url} returned an unhealthy status code"
+  }
+}
+```
+
+If the website's endpoint returns a `200` status code, then the website is healthy and the check passes. Unlike other ways of validating your configuration, `check` blocks do not block operations. If the assertion evaluates to `false`, Terraform throws a warning that includes the result of the `error_message` expression and continues the operation.
+
+For more details, refer to the [`check` configuration reference](/terraform/language/block/check).
+
+## Continuous validation in HCP Terraform
+
+If you enable health checks on a workspace, HCP Terraform continuously validates any `check` blocks, preconditions, and postconditions in your workspace's configuration to regularly verify your infrastructure. For example, you can use a `check` block to continuously monitor the validity of an API gateway certificate. Continuous validation alerts you when the condition fails, so you can update the certificate and avoid errors the next time you want to update your infrastructure.
+
+Refer to [Continuous validation](/terraform/cloud-docs/workspaces/health#continuous-validation) for more details.
+
+## Order of validation
+
+Terraform validates different aspects of your configuration as early as it can. Generally, Terraform executes evaluations in the following order:
+
+1. Terraform executes input variable validations immediately, before generating a plan.
+1. Terraform executes preconditions after generating a plan but before creating the resource, data source, or output.
+1. Terraform executes postconditions after planning and applying changes.
+1. Terraform executes checks at the end of plan and apply operations and every time health assessments run on a workspace in HCP Terraform.
+
+![Order of operations for when validations run](/img/docs/validation-order-of-operations-dark.jpg#light-theme-only)
+
+![Order of operations for when validations run](/img/docs/validation-order-of-operations-dark.jpg#dark-theme-only)
+
+The precise order that Terraform executes `check` blocks, preconditions, and postconditions can depend on whether Terraform has information about a condition's value before or after applying your configuration. If the relevant value is available before an apply operation, then Terraform performs the validation during the planning phase. For example, if Terraform has access to a resource's image ID during planning, it can execute any validations that rely on that ID.
+
+If Terraform only knows the value after applying, then Terraform delays checking that validation until the apply phase. For example, AWS assigns the root volume ID when it starts an EC2 instance, so Terraform cannot reference the root volume ID until the apply is complete.
+
+During the apply phase, a failed precondition prevents Terraform from implementing planned actions for the associated resource, data source, or output. A failed postcondition halts processing and prevents further downstream actions that rely on the resource or data source, but does not undo any actions Terraform has already taken.
+
+## Error Messages
+
+<>{/* TODO: remove once we have an input variable validation page, because then we'll have error_message described on each reference page and don't need this  */}</>
+
+Input variable validations, preconditions, postconditions, and checks all must include the `error_message` argument. This contains the text that Terraform includes as part of error messages when it detects an unmet condition.
+
+```
+Error: Resource postcondition failed
+
+  with data.aws_ami.example,
+  on ec2.tf line 19, in data "aws_ami" "example":
+  72:       condition     = self.tags["Component"] == "nomad-server"
+    |----------------
+    | self.tags["Component"] is "consul-server"
+
+The selected AMI must be tagged with the Component value "nomad-server".
+```
+
+The `error_message` argument supports any expression that evaluates to a string.
+This includes literal strings, heredocs, and template expressions. You can use the [`format` function](/terraform/language/functions/format) to convert items of `null`, `list`, or `map` types into a formatted string. Multi-line error messages are supported, and Terraform does not wrap lines with leading whitespace.
+
+We recommend writing error messages as one or more full sentences in a
+style similar to Terraform's own error messages. Terraform shows the
+message alongside the name of the resource that detected the problem and any
+external values included in the condition expression.
+
+## Conditions
+
+To learn more about the conditions you can use in validations, refer to [Conditional Expressions](/terraform/language/expressions/conditions).
+
+## Next steps
+
+Validating your configuration is the first step to mitigating risk in your infrastructure. Refer to the following topics for additional information about mitigating risk in your infrastructure lifecycle:
+- [Tests](/terraform/language/tests) help authors validate that module configuration updates do not introduce breaking changes.
+- [Policy features](/terraform/cloud-docs/policy-enforcement) in HCP Terraform enforce compliance with your organization's security rules and best practices when running Terraform plans.
diff --git a/website/docs/language/tests/index.mdx b/website/docs/language/tests/index.mdx
index e15ef8af22aa..140e0d3c4d37 100644
--- a/website/docs/language/tests/index.mdx
+++ b/website/docs/language/tests/index.mdx
@@ -14,7 +14,7 @@ Terraform tests let authors validate that module configuration updates do not in
 
 By default, tests within Terraform create real infrastructure and can run assertions and validations against that infrastructure. This is analogous to integration testing because you are testing Terraform's core functionality by executing operations and validating the infrastructure Terraform creates.
 
-You can override the normal testing behavior by updating the `command` attribute within a [`run`](#run-blocks) block (examples below). By default, each `run` block executes with `command = apply` instructing Terraform to execute a complete `apply` operation against your configuration. Replacing the `command` value with `command = plan` instructs Terraform to _not_ create new infrastructure for this `run` block. This allows test authors to validate logical operations and custom conditions within their infrastructure in a process analogous to unit testing.
+You can override the normal testing behavior by updating the `command` attribute within a [`run`](#run-blocks) block (examples below). By default, each `run` block executes with `command = apply` instructing Terraform to execute a complete `apply` operation against your configuration. Replacing the `command` value with `command = plan` instructs Terraform to _not_ create new infrastructure for this `run` block. This allows test authors to validate logical operations and other conditions within their infrastructure in a process analogous to unit testing.
 
 Terraform v1.7.0 introduced the ability to mock data returned by the providers during a `terraform test` execution. This can be used to write more detailed and complete unit tests.
 
@@ -162,13 +162,13 @@ In the above example, the `first` and `second` `run` blocks implicitly have `par
 
 ### Assertions
 
-Terraform run block assertions are [Custom Conditions](/terraform/language/expressions/custom-conditions), consisting of a [condition](/terraform/language/expressions/custom-conditions#condition-expressions) and an [error message](/terraform/language/expressions/custom-conditions#error-messages).
+Assertion arguments in Terraform `run` blocks help your [validate your configuration](/terraform/language/test-and-validate/validate). Each `run` block contains a [`condition` argument](/terraform/language/expressions/conditionals) and an [`error_message` argument](/terraform/language/test-and-validate/validate#error-messages).
 
 At the conclusion of a Terraform test command execution, Terraform presents any failed assertions as part of a tests passed or failed status.
 
 #### Assertion References
 
-Assertions within tests can reference any existing [named values](/terraform/language/expressions/references) that are available to other custom conditions within the main Terraform configuration.
+Assertions within tests can reference any existing [named values](/terraform/language/expressions/references) that are available within the main Terraform configuration.
 
 Additionally, test assertions can directly reference outputs from current and previous `run` blocks. Pulling from the [previous example](#example), this is a valid condition: `condition = output.bucket_name == "test_bucket"`.
 
@@ -757,13 +757,13 @@ If you use a single setup module as an alternate module, and it executes first,
 
 ## Expecting failures
 
-By default, if any [Custom Conditions](/terraform/language/expressions/custom-conditions), including `check` block assertions, fail during the execution of a Terraform test file then the overall command reports the test as a failure.
+By default, if any [validation](/terraform/language/test-and-validate/validate), including `check` block assertions, fails during the execution of a Terraform test file then the overall command reports the test as a failure.
 
 However, it is a common testing paradigm to want to test failure cases. Terraform supports the `expect_failures` attribute for this use case.
 
 In each `run` block the `expect_failures` attribute can provide a list of checkable objects (resources, data sources, check blocks, input variables, and outputs) that should fail their custom conditions. The test passes if the checkable objects you specify report an issue, and the test fails overall if they do not.
 
-You can still write assertions alongside an `expect_failures` block, but you should be mindful that all custom conditions, except check block assertions, halt the execution of Terraform. This still applies during test execution, so your assertions should only consider values that you are sure will be computed before the checkable object is due to fail. You can manage this using references, or the `depends_on` meta-argument within your main configuration.
+You can use assertions alongside an `expect_failures` block, but consider that all validation features, except `check` blocks, halt Terraform execution on failure. This applies during test execution, so your assertions should only evaluate values that are certain to be computed before the checkable object is due to fail. You can manage this using references, or the `depends_on` meta-argument within your main configuration.
 
 This also means that, with the exception of `check` blocks, you can only reliably include a single checkable object. We support a list of checkable objects within the `expect_failures` attribute purely for `check` blocks.
 
@@ -984,7 +984,7 @@ run "same_state" {
 }
 
 run "site_eight" {
-  // This run block is entirely unrelated to the other run blocks, however, because `site_four`, 
+  // This run block is entirely unrelated to the other run blocks, however, because `site_four`,
   // which is one of its preceding runs has the `parallel` attribute set to `false`,
   // it cannot run until site_four is completed. It can be executed in parallel with `site_five` and `site_six`.
   state_key = "unique_7"
@@ -1009,4 +1009,4 @@ Run D (parallel: true)
 Run E (parallel: true)
 ```
 
-Runs A and B execute simultaneously. Run C waits until both A and B are done before starting. Finally, runs D and E run in parallel, but only after C completes.
\ No newline at end of file
+Runs A and B execute simultaneously. Run C waits until both A and B are finished before starting. Finally, runs D and E run in parallel, but only after C completes.
diff --git a/website/docs/language/values/outputs.mdx b/website/docs/language/values/outputs.mdx
index 858700414766..813c3aa25d97 100644
--- a/website/docs/language/values/outputs.mdx
+++ b/website/docs/language/values/outputs.mdx
@@ -63,7 +63,7 @@ In a parent module, outputs of child modules are available in expressions as
 value as `module.web_server.instance_ip_addr`.
 
 
-## Custom Condition Checks
+## Preconditions
 
 You can use `precondition` blocks to specify guarantees about output data. The following examples creates a precondition that checks whether the EC2 instance has an encrypted root volume.
 
@@ -79,9 +79,9 @@ output "api_base_url" {
 }
 ```
 
-Custom conditions can help capture assumptions, helping future maintainers understand the configuration design and intent. They also return useful information about errors earlier and in context, helping consumers more easily diagnose issues in their configurations.
+Validating your configuration can help capture assumptions, helping future maintainers understand the configuration design and intent. They also return useful information about errors earlier and in context, helping consumers more easily diagnose issues in their configurations.
 
-Refer to [Custom Condition Checks](/terraform/language/expressions/custom-conditions#preconditions-and-postconditions) for more details.
+Refer to [Validate your configuration](/terraform/language/test-and-validate/validate#preconditions-and-postconditions) for more details.
 
 ## Optional Arguments
 
diff --git a/website/docs/language/values/variables.mdx b/website/docs/language/values/variables.mdx
index 28769f72dc4e..3d3ed7d4adcd 100644
--- a/website/docs/language/values/variables.mdx
+++ b/website/docs/language/values/variables.mdx
@@ -174,7 +174,8 @@ variable "image_id" {
   }
 }
 ```
-Refer to [Custom Condition Checks](/terraform/language/expressions/custom-conditions#input-variable-validation) for more details.
+
+Refer to [Validate your configuration](/terraform/language/test-and-validate/validate#input-variable-validation) for more details.
 
 ### Exclude values from state
 
@@ -214,7 +215,7 @@ variable "password" {
 }
 
 locals {
-  # local.database_password is implicitly ephemeral because 
+  # local.database_password is implicitly ephemeral because
   # var.password is ephemeral.
   database_password = var.password
 }
diff --git a/website/img/docs/validation-order-of-operations-dark.jpg b/website/img/docs/validation-order-of-operations-dark.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..b747d2fe8feced2559ffbf36759c86a889d49b58
GIT binary patch
literal 37039
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

literal 0
HcmV?d00001

diff --git a/website/img/docs/validation-order-of-operations-light.jpg b/website/img/docs/validation-order-of-operations-light.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..9c60ce210c034bdddf7e673d7485d1bce5727126
GIT binary patch
literal 36972
zcmeHw2|QKn+W0~;C)yHW7eXX+DC|n+5He4dWG3@$ha__mN}0)&L}s!PGL&JPLI`D^
zhi$W`|8mYf=hFZ8|IWSNJ>R{Z?@zx~t>t~+^*-Zz-sgRu=Ouh5d<70G%PYwPM8p6<
z1pWaCLx3zme()gKK~i!uGBOGZa!P6l4K)=NH52_2S_msMl#P{{h2;e2S?&|;XE<0`
zc*IYi5fl;?6@_w3N=pb!ofQ!k-Wi05f`WpYiuxE0%`xGVEGLEk=^sKZKu1nIPI`ib
zh#erNBO;+AA~XO{aGs<@zx)7y`ynDGIY4@ljGTg!3T#kv7$7DhAt63MLP~nz0NC0W
z{5^1hj+FkS(4~V%G;WfyJ3@s0AE%OYTrR9*(Ck{~6uIRTKtXww@fZ{HDK2iF)4ZZ$
z=fou>&&ytslUGnwQr5bzt)r`_Z(w%Y{EmgCm9?{rtDC!rr&r+ppa;PZLqeltp2Wt*
zKYf;vmY$LMGAlbLx9DwgNoiSmMP>c_hQ_83%`L6S?w;Ph{?7x0W8)LwzE4g~&&;l@
zuB~sNHql$#J8%&JB)@_M{{1UpKfpx?!bN=G0LcNe9k_^y-NB25?f~gYp@a07G{|l`
z9$^>uCx={qoLX2%!6Bl#%y7%8i}EO^=-8>19ngM(>>mRx;J*dg?|}Usu0epBga{-a
z2^|0fHn(}w?osYv`#9L=fqfp>=Yjt@9^eybK&<jv6M&8H;`n=(1mM2SWde}G^_&3Q
z%fT~P^Y+`i>4@><>Qu@+GZRm=$TBc&i>Mm&zc$f*LVGaYK0tz&&LdsBdl9R_T0EO~
z)6U^kxlqnv`$hXN8%vt{9yKTw=6zp8Db=&HT%|oJyuz$UIN0uO9NWm}H>`7<eLJUF
zGN*vcq1F(jn`&EamYi#M)ck@z-v>Xc=Mf;8z!zpd#7^4$obvjS>5H(|+?6+x+Sp6u
zR(@;(A!&Ua5o6RvvZyN#f?JJ5!$ScV-119n`bG0C-j|Ad<(foXwhDj6uOskCK2sM+
z3g(vCF!y0#MjutD_N^$D<X&Ji<q&qjRAA5d;<Vm>&_Eyy=;!OszTjLX0Pa<eE<-UL
zws*o(1o^9t;Q|pK&uU>P4THPK?9yetcsQrZxlibPcpzr;No~_4boOGKRkqaOdntAo
z50bIk2>OU2(~&0wD43<?x%C;Z)d^IeTNrYVvMz+)FEPA;!6aU2C^9&;@ZL!2a8X3l
z#NvRc%r)L2>&nthn*s#ti-EP(;ETeLk>1<H3{aN<g#we35CTBK9h$Q2imH;{-r^Uv
zGUpiN6*=j{c)Fd4^`NT#ER6OOE`OuQhW<UnWXdLz=l)@(CP?@y5feUEY$|X=T1DZx
zDq`h$$B|<n^@<{4JUJaij!93mTu89oIjY$vM)oVbv)PZsn?$?q-o(_k%yowA>g#Q*
zJ%6QdRGko6vmGvX?v<()i=iRMWb4|j(2^kotz!^FvP@w5myc`e8K2wuUc7Cw5C7=f
z!qNj@j<7UcKhO<dW`Nb_b}pgeb!-nZ8R7{5d0!9#xTq>l0Eo1(JU?(7#DH~lm;f9Q
z72|n@K+6{kY!h1{(3Htz3Rn&UMjVmoD3(-xIjwUMzl1)Snj>dU0P4k3;hjfR2|(?2
z0ze5HW9~#uQ@kVqUwPp{M}yrr;dL}L%6tNNx_m19y#xn5aTZ$R$5|9#Kvdz$Ev+^5
z_slzL_YCAxhjF9Jva*_?Z9h&LzIP7%hn5xzKmarI6CKmt(@x(r2TOOjJN9sAPg)TH
z*fVM9Zq$XzR$&ldAMB%UH~IEa2P$UBKG*FF?7v^v)f}IyAG`!x`%a6$$K$9|dDGlX
zEtDtwu!bB2_(?9J_;J%Mh7$PpDrmx76wA@~J4FB<8|o5(g42j~5`$QWuO<cS(2HrI
zyayl}a=>5ZVu&9r*kUM-+FlI?;bH*cV%~vE5rm5ezD}f5LpF=hSQq0-3-u?3Xk7eR
zE~X#R{{wk+@T9W@;L<v{*iX462f0S{SGj(`zd`I?`q+H+%iDm0_QL<C(xF58A&j42
z%GhCSU|~{e@raKWi>*DyMu#>>mVuP)c$+${i51FesKe3G2g4r8Vj)TLB3bkFfImVG
zq6wrGl?*#z=#Oz?NQb8qd7|u!y+gf|t$S05LsRpu3oR3*+cTvcICbVKVufOwSuEz%
zk*+)&zFhqpL986*;flHFX0m>W9@P^aw#;#FW08jQZV_jWNc9r{$NuBGbL}=xVW7IY
zL3`AI_E<8Fl7p!GDe(_{W@Zsp<x|okLxpLz4qbZ8{bBr~b`EMtgAuF6f~N=Q%*ZKf
z`D3~ZzS;PJ-SxaiLl#`5wUpi@QDnquJ#UGKIi^)1ucnSM%T&LakE_zJ>8`1BryYQQ
zuPz*ygbz#44EX2CY4&dLtow4!X*^?{C<||HecD3OEjrAo9cI|IP{PCEF<x%mS`Z$o
zI0aSKA;v*;)Dp*~VLBB(`L70*xVn?u5|!y5v{BQVT<<(s!tg9*4mOnFS%snLP2xQL
z-I%NY>mkRPPgb3OiWKd0_<!|n@a$+b)VJe6N-5aF;5VH}=%&@=eT&KofWNl%xk-Uz
zSUr5#!=>)^Hgn6CX*CI~yAW)dd7af;G0dcMalOU#))%f$jB{aSU?lnkbJH?B;KuUH
zWN%yhn!Zh2@s{sfaGqmS;mJBv(z8ABJdu?6d80w=vcQJ(lUZ;&w@70#P8B^tk(Oy-
z>XFy=%J_$31K5*aG1+2FNYtb!hr2#yh;mKu2-ye=_0&iupL(!YY}_;V^h@KqQA*`!
zu3qj{SrrNxn5k_SO1AAG0L!miy4G2xW)Z6t<yL{XWSqUJn^0BM)irGo|KRZ<Y2Eq+
zvB-|Yvy6<41_95^g^Qq-PU&Qe80{qnqxX*EeZ^J%C0q|A9t?{pMPNJcN;*}uW#EL2
z1;VQN!F8)@{tK8bMqnW8h(+sY70Iz#q3Z%tOnynHEBZkJo2NHUQR-TV(-?ZG{suM$
ziMi-_lsR)_GyrR5=I-cz=A3O9<p@jLv9q;#P}3)lpC@0zZ&~ZW5AplRkv()JUtIXA
z#1V9Ai1NcD;vm*#Pws+Dm%ijf2K{RN3x|r<SWRzQ-42|*{K}Afa_epRwzdV@Ax9?u
zV5pCVWLLjc^yvHqXJE{O_KO`SSp1jNpAp5oXSd{`-`6JG&poQY@V=Z?-1&v~owv!x
z$qinmS<)M$57R=KuDU(85{iE8|AO&@R`=*g6{djn{n?7t(V=0_!!tq;k)y4{?-bOZ
zb3h;Gy0eiZN_qtZq%IV+WM-~8l;5xAG#+mKwgRF(;uI%oa&To*em2@OUO&{evg}C{
zXOeIP`;EhDUP+1_B{#6DA?t~zmshUvx*J|)k7w<_a1UD+)l_9iBBx5GtRhyC@O_gp
z+VlCDd9UP~3#uz;gBU|Zk4K!<mnsk^H6N-nBPN$<UI#rf36tgRN3J}RQeBbN?x(+U
z&g(Xp1gAs!A<DpY0-)C$4EMN=6j&NxIf%%y7OF6>e5=n<^6>Uu=UP@TZ{0Kxv$}J5
z)@9t{lTEIvg`nzzD}MUCy7oZJw8&PUDC|&)VzJV?09t9lCF_gMsbb>+ZmCk|@YRcR
z3)&xFbI@wnl=oz!?L1xZw^!S#YGhW{*qLy=>wfG#E(G8(deF>Os>Phb#^d&*BKd*Z
z`j~r?3x*M2>AO5`9?BvBCnUwE<_W-DjjOHiQvBis!l2CRYc_jd$<W;Mg5pbgsS#gS
zOXtZ7KE)(AYq*d>wvVQ}E>BK1h@gWt;ugn;Gou;fUCuniRH^&;DU@72+aLohH&)Fd
zXCAfEK4UEsQNJth+r!tqv=Ggw@5f?olldtv3eqm>))F~7Klezfxy^#pBKjZ^DvuFL
zdkS+j1jTAp2hYgSTcjq6t+QRtSlLQ&H?Ey3=BtWbneO5*aQ*BuG^9Z4@a0vmn|S*(
zOm*ZTo@KUZ-G-6Vv9A1ASY^hZ5WyH(T15n)LKBh`(KfknmQ}y8@t3YJpep<0g_<<4
zoU0=-S3G{#@0zeg-L$V|(Xw>Y^KtJ5%?^X;3o0{gDq*tZ7g~m~`qNbO5~z%C_r~+3
z3}5MC&)8(XOER2`xH81wfMm4nzae$BBWupUkK;`bmc+s=f6!(-Vq$BKwMX39A<`&7
zjm$o{XRWX7RSm0w?AL+n3!WbRlxxqBu2DB5-T)_VZ$oPnf_#XwP1WxtomhcX#zs6p
z7&_EUQ6Bj`QVq_MRNeLQ-ls}DvJZcHbcSxuASf}=;7s@<W%+|WFdnJXoEs$lefb`g
z<M{5z^LT$pxTB|oWo`Xh#T^sJ9t_=<t}Izlbrj36NBqL`YV-k^#cE+$5Yupy-%^&B
zXcQIP9G#`zS2Hk)LqIE5OSgOofHybnQO01&z3FVw$_@HgtXy-n4PMTU17Dp=06Iyn
zbxa>1zUd%gbFEMupk3g<UC`r8qx_SZqz6qy;NNt5K}l$JzyW=k=ID4322*@B=<n*J
zvDQZTdm%b~iGMPS^AFdBdvLD<LbaPR254w5P670j{bZ}PA8@bp18EG=jCnY+&Yx{D
z_J@nYy~y7ei~pco<1Z-|=M<5aNvAbT#5G@q3m;=ki5!0m-{ao4*0`Q|>MiS_@PFm@
zF5$^q;2sVd_@n&-h8#IIr0-|rXa8@%y}=WW{h@x@$=k=(*giA-wynF*4ExOR`yT)Q
zpUhC49&s{+J%oWnjxsx)=;Aamf4WE0DP}lm2y{hf{H0vce-)Sce|(;D&W;R;ulhx5
zns3TS%hyR<6ILUW2BQP$BLw<32>|ID0a#&BrjKj3I%nIZk22_uOO<>ux^SU>5%>L7
zVYsjU#e7ONe#=H1(2!Q7J-<R0BET<YnyuF|elx?M&W`0#pbbmamq-O(RfFZtha35_
zMqMWmGRnhNQBs|rH|+0z<8x_lz32GC+4u}IL=YXlX0WE8Q4zu}6no70U87c?kI>ny
z{JK1Y+5V%9g0(je^7IyEe8bIF<=@Mj@HNva3T;#C{I0j5QtGb5n_nub`Kj)J(_PZr
zHYS3-rpn9h>1ktwo8BGv5U9wlfN2UQvXj9qeMk@XzFC}uSX+D_r=rvoMxks<@uTfz
zOrV4Lj1Qen*6=_J&6l*}7b@&i0xj!3!vgMYA4<F5Ndp2fYP2G~UFSS$m4>89QBASq
zPaKeFcM`lLb*r+nw#$dxJk`b^F8$6T>B@ok{-q+(YSKmO3<%8yUjSVAT!iQte|YGE
zF$@kcEm@KcENZoY`jcP6@(Q4pMG=OhSjG+l(4dWxtO<9!^NAq>^b^X*&v}EP6I%oT
z9SR%cLE;?X%cd{_K&McYe21l=@U5H~yj~-7djyQ{sDb0zqjry^F`qRM%r|e_r8m0#
z#LBM>ffh(601wmm5EtTo8g;W3b6iwM9D9n{G=B+CHAMi%cLGt;RW{xcfI862fR$rw
z^?mA8)3iUUeOxu{^VPl#{;$>yCH$}1t4bbBl8sU~bIR8-X$sTI^t?F5+Nqyr@RM0W
zKX^cmtvz;oK+XG>(K7IFnxEq+Mn+U;!Y5cl3voHl_z&N&XTL<=Fvj;(5CF5)bd2T{
zE~+(0LnW5T{n!6TEvO`;V7!@fEZJ0u!Fbrb-*vdP5dkRN(&pv)e)0e6slZFTgv#u|
zKx3i5wANM*mArN+T0TzRtx50O_;Wdii~rTu;eYCP3^{v3Na78W_JojV!2+l7H&8nv
zB(;yyLV19n<RaM<qHJ@vL`sDKu$LAP023|v^ueMz4<9IO^|URB)@y(0;rv%N4gT!D
z)*icE-R6B+yEY-NcYFoypr_Ii;4Z`)PLL!!Hq}pYwXFzXLkAH!PcZ5>g}E(Xot^+R
z=jRcC{wJf`M6W7Gpky7`P(zRs*Z-6-gn!qn;Rk8Zcik&3BA{-Wq%{KrdR|e0E5!e~
zi2Q$YY+>vV(xA0Fpx@?fS#TY=tYMF<lY?mg;a<!i#qjAu$EDr%N>=2O9%q)k5f^-L
z(45o0&7G~yILLD}>}EwdIw(`l!V%^DpzK=oLVI_`RwMD90FOYEu8lT6RyRI{2OFgd
z{52kuB!~*us($%xR1CAoxpZ6NmhZ_UhmLp8>A58xu8!9&>v7H3FG%{l7%KSuqVy#!
zu1ZHCu-JxGLAx)j+TX(Rb!byTvr)9thXRt-m&}Rzi)EQJ-Q*4eUmwV}e{f80D>1}e
zfm&b`5}}XF;LpnKhUSu<76^8wyn9#GXQEiFZ?X1N9hYI~73pP`LI7wpWjz@_W!+;h
z!`SMcyF&nIPF37WJvZfW!m%nj|0q>bjK%92gZq<IDj3g9XzgoZzog>11q;<~CLI*&
z7*hr1LJM2@Ywv3%%lYs69<?4ly;(4z`t<mVZ)Os+=be0K9|Y4Rj)r4pajze>+%3Ar
zP!2>1aHq%&!AKO(x+M>uGrcKZKYPUb;MKaOQMD31beOz;`u$nAG$nvXs;*fYc7E-%
z^2@LZ^87<C-(!7Vuw-Ar_yK;gW;)1MC(#z>uB@+AoUYj4p%jlEcJfLpuAfRBwbn7X
zeOYBFJ4IeXb0Iw0!Jsy*A==mj367sYQM_gM(Z4%djTT=2=KHFBwPX6r{E~%;fMfSZ
z9iQgRC7qvI&#}AtCU89WWm4f8KUqe-!eW{37iLk)#FL@uG;dlOqfwI)t1@?$(|S4s
z?fn>pK+o;u){Nwaq7e`4L5zA$cmAS&rz$E$=E^B0zKw}>v6dOZ58UrrZ;psss6=ao
z23#MPNs2vJU79}j@`+u;$&ZDeF9n4S+u-ja34j5qbJvn9AOAUqIMgf;LpkXXlgvo5
z!K{vM-zP^KS4d~Uh|7)3IA6Yq3Kj3Dki4V0bSZ|{?4oULxk(DYu2rpOpU^w8()9LF
z9Gx9a7*m`;`Ekpc$nyk1MA7~H<_cFBv;0!7K~T(MvLFj8PxpLmY+~-Pk@0&7O+=AM
z_&G1LzUs9r$X8rwyKLh&n<HOt>ChJiv|e`%?9rr>*nm=_Z?no%d4F!hC0&T+lJxTn
z4v?s2+3u!F3c8tRwVhB{SoOdc;lXh`DmyQ>ep>4}oLM?4HPfIjM~WNA{^|2cBa7H}
z$qy#)_$o8VL8X51Uo{8zKkI)S?W*})sj$2!wdYisPSt(8$g3~1r$$*n8G~v(%Pe!i
zD*uAPMRt*zEppC9nQEN%cL-5bwuhlyuf1Ql=dCEA+1ZboHRT*)9#*BY>i7=K8PnTC
zWi3Oi6Eiy5Db&8O`pUEMuBhiK2b6*p&U`AHiFQ=)!HQ?t(1$p@iq^l_wA`q~_Khx~
zH_acyc%@rQ#ZHW$!|)uYi~62lR*uvmt2<rATk8$o=A}AsFA_J#_(vwL>1L<gu}@90
z^2#jM*^CR}yc@32LaK0;_>fhp2@6tm?%^W;8O_t+=jiK;uXw4ASsTqzprf>Ny-kJU
z)s14glBY48x1*0eB7>*o=8Z|y*ba8;2|PklC^MR^0T-oxDe`l9NMKr>>%+H1RWMhc
zat}+MjGtBz)wA@nkGDDXE-_7xC7m`v$stE7p)>6sPhGkdYS1>p<y>oNG%@oDwL@N;
zpX9`YU7oFfF5a?Dx6vyyyR6=pq;|;Z{B~a=gy>l&+FQ9RF{%F3Ew^K5_1>Cwb0&2E
zNd^p`)_c=cJ}c<PP82#HXby_)n1hc&bMP7gm?nM+2kno#d20<h2LF@)F5}@Jc+Wq$
zcmXv+%Fkq9{NY@Bmis|_Pyy#D3)+K}pgl+fZ_dwv_dkJc13Ae%#)qIc^Aj-KR`HLl
zi+|(qf5;L5mqL581oU02WoVPPAf+Jm*<eHs7<l{_xqg&}qPgAD!fUY%IygVFHDy9H
z^yvT956_?3-@+r{H23mI4nz^Dh>Ff-505)V4$vA*)qFv$&E&v;@%L8o@+tNx>8HMQ
zMA(~dt@j}Q=9wCb$NP#2{OVBFHJ8&ZiE{XW2Nom67r<manS}ViIe9To1fb((=5HS6
z`Rw$;4`mYs064qfavw`O+W`9<vM(Lr-qXHj*w>2x+rJ%rsmoZ+OJncOp4Lcz%+IbX
ze~kAsaEYxXUGD13grdu~pc(q{(m!C;679G7>*Oqgv?4K&lepz+?iwko*}ixeawsFI
z9t_bu)d`;#-zl4*36Eggv4nMh%a=7e<)WF%)HI(F8+Ey)Pqb~T`nj}x`?!()0QKxb
zlo5%pP1te)HfRW6A-={isN;Ggo$sVz1}C6&f~Y6KAU}J609ab}pYwCB=Z;7hR)}aN
zuWRz|yCq>tgRVpofJVfOxZ?Jmmv;=wABaHXJUSf9Z?EY+M(62So;5G+KReYMy_FWI
zdend7F^PXboyUYUM%UhlEKR}TM(HE|%*H2=o8zygg|K98MoM;g^>nT)iXNA=ONmoD
zsz2g%yXlfyw8Vn03rB~T0R1f8Y|@EvkATII**>RI9Y=!@9oa}oVitlWVP>61_j=8W
zTB<pmL!Q2VP!<3@HO~j2m-?k`oK?C`APZdivNIo#;2q9i{9OOSjAZbwLp28~-)Tap
zv`=8(qWp>yX~i{i4gVhIvk#nCtVd48=$eujBdMkrsf%VWF+NvIEeyAp974W>+~s5I
zc;97UW0NP=v-SlSV*9xz>IF&S2a=^Dh7A1oz$MVVj%1Urg_j-{y{~S?9%AAwmou07
zn#2o3E4e_oX=V^;Nb-bHQV9V#`Mh9rHpsQ<KJ(Q)jw&#OA^sA$0viF-p8b{ZqVReZ
z(6!m=uu~f&g8(p(@nmgycm_QN3vB%G8`vK5-+iL7-|iQT?c-&iUv?yCpAYu=;6KR+
z$jB=RoN?T`5w+&7lGL=9X&p_>jYq+~V(q^rtm(K~$<tLHjNREQu4wr~huuH9!T7I?
z_v_~5>)*EO%as>@*{$65VE#Q8Dje4sc41)t&RYIwz6pE94hC;Ly{bCiTL6b)h>^3N
zV5}rD{QU`7`9>)RbmW*50K}~#%gp(S&u46QKZ`;uiNUt!5u5Wmst|7p6czL6a<nyk
zZ2-RX8H@(}`@n4N(g96nSk8oGEXovv+6e-T(INmzpwq~&@phNO+o&6b`CwQg7np-8
z9goL>F^QaD((V*kvT3wXUsPk~%}P?MM(u0LPK!=zLK<Ci*Xl!gUjB3@@g8Q;rPy<;
zb1W)wlDjZR4x-C+@+Y$8fAN-U|Ca374^A3Pe%yWk6dpLK`59cMe7X4(P5TdNzX$pI
zwD`aAWifX?1$joM=jNK<-70spd~+y62Si1>J;Irx>c&<@bKT5mO}mpuGnUz36D~aD
zNZ=Y~31w2x7CR*r1kpY|tTR$SiyYB@^samUa?0UD7pIaP6{&hO<OF|LV|<7DP2*PU
zC&x$CJ=vIi5T{K~z1!BViZD5@WP7tbR4#7$UM_G!odwz++xgnE>-ylLV=jO8TW2EG
zrU@{uc_m!Cb!W@=?*sm;`g9Syvw`*c_YJHaExGr}n+6}K&@Z7t<$p=_UMC09nfRRm
z|4n>JE-`_DMgSORq>V4R6w`1%DT?7?VE~_d1X;rE1F^^I<`!m*kLJHr$kX>t&}U-2
zYg=H#+e1grKOUsSE=ozU<RALnIP?P-%1)-lDy2;-06FsID7o8KMEK;(B7K(vdezJ!
zwFL)G(yrTfBZg*JylX+u^keHIjZSY>99$3Af1;aW3*LCCXDO)PBGs*Os<&aT@Y|DB
zU1V$tL!@ecQahua=HS*@@o%QGT+5Q%6B~I6!};%;($lV<@{}9m@f4OHTc!5LawmXF
z?Y<s4bC(!jX3?FNz$l{$F|hvTdsKfZ>M>{ZMLUU*bg9VXucw{f6vn!f4f)79q!kxs
zJ~@2wGs}1MqBjZ~p{I8!AR(l*=Ro$Ocoki{PfWE_1!}(1yx&KICn}C2!zw1K{fVh!
zVIs6}69SM3Q}4{5k9gn48LwqTQ`B<0<>t(K){VlB#*A0^<95c2i!`XFrz(?d<lIrn
zXWs74*|KB(R!OHV+~i#(V4k`#la1Ftr;o|nCj<=+h}<4}Ffo%*<(N98em1G~6aD8>
zGr4I`vgFn<!NSneK>3xR7e|ZQz8lG34PAPHTUtK&EM1?*&#(>C7ShmmTCrYcQ~&{;
zDsd5KzN*Xot~3oP5luP>F(WHL_ex5ML5H}K22qo}+>&t;ktDv-Ja6<S`3EMJ<1)0{
z$6V6yN^~ff<>_D99HbI*vJW_uEIEJJamLVU%-eFkV*aS7Pelg(ktX>IezE6LQ)J<!
zX-wZkRjwUyIyqH_rZjq8XC@B4vyz!#Z9B=ca2HZ2Su19!&>i34)-S%<e}pMKNXzD{
z!aZ7&mHg@AD^XejxYwtmEmP@yMjPvxWU#&ZK7vUupR9ZxZ6H&^a!gz5-N?kJdQ<jd
z$MXsf=Be;KW3QqM5ox2zScNlJ<$g|NUsA0Om~>0hzZjdih5)Sy)6k*v<>8FMD_+(j
zjr20O_oPqPTClUeDvDuRN9&bXrGiJQ96zzVI^(=ulGxRkm9*MEj`|obf8r5-X&D+}
zgTCc)2if}GRdhB|Vd()AY#_6|Q`}U=)52RiBL@D8BH;KagM%_M1!;Fx@NLDNFN;&B
zA}FjWtWCi5`PP3`{wROcO8a{1KOY3RPm}*V4SxKd{jZ{l((X{}>N$+sdpz6@u>{ua
zi*Ot3zS~`4WoeL>O8~4s!#ftra5&SI^xbV7+Rnaz%depgFP?`@p@#7I0(2KH>m~t!
zm5y$1z?&lV-Kd0n8FY8|feyMs*D!Vj0IrL*{2qT}zyCh|_W5UDe)jdp|4V<m|56K9
z_qSTGCa$|x>^sKy@V|#kQeU=a-aKNk6OiY4_|FXB+8^t$Q%iWCR{sF4w2hV5Fc*}o
z->qUh-qx<!wu{?oIwlSCwIjwH2tW@N0pKD47|OvowoGjgzSv{RhHT0D+Yc%-t%Nzf
z9;7;0FAC?K@mFFSc<oSMBLlAapX=Jt&Ud`M#T5fjMx>G)8<e&#3uS-ze4H&jj&7hu
zvgkRL2SpUql*E*1mh$!QZDMy$%QX%p2HG&+nn4V5;fLl;*H$JYl9QEHSS_yh<ln9+
zLX;(u6M(++isWhpKs;;0#N9h3nMNi==1rGM*10U{-ql8?)sv5V$d?hr2iR(gt%a?;
z;@;&CTjiZekU;w6&Db73jAU#c>J%aUh9S{v4Y^P*rJZ8*LF&;g%Ki}z@-ferykqi9
z#mTtthHX|H(qPcKFQ$XbO@Srl?F|e6b%uJh-#FQdOpMvojMp~-+u3-*OGSpascIi9
zv<24IO~GDAJ-8J&;&9|smQ`uLxTE#z8O3>y`jr>w4oP%CBvKRKE#O{0x9t}%qcg0{
zAmI#$5PLamn9ecV$3vV(O)ojHARIIArdF*OiHA<s^l#7z$Uaw&z7xq^T~ku}Ol>3w
z+CHS9mC%H-+rU2`Gvr`_4JP=dpfnX+qn~%(6*rSIV+n;^T<<_D7CV3?B+CeZwZU;!
z40Zjr>*6nceY3+F3`9}RCbGE(N)89529934Y~i1*yw*X7_QEJ5&kEQlv@Li&$g!@c
zy3I#y*UaiUCDk*+wTw!&O7#dd=rO35yi*)GeB+Hgg+FiNr=<L$83kUt>4ofp%r8gt
zoe!6nYc4nG**`j@MDp$oBPw28WT?)OCC2a(*A?5REz`7_cN6e=>2rR^j?8$yP|ck=
z9QN7Ztp2&Lf-)aY(5=6Ys!O<KHNsrtJ82l!$mo7Vd?Z?dC<K-Sqg2(Wp5`fl_0@nZ
zXf`Kq07oe#ev|1CS-9Ztcl;1<FqWSHZ2QB%jS_&H#&mVM(Uno-5e%nmg0s3zK;xSV
zj!!Y&5+?wk!NV~AextShfMW~JfWJAP^?7}p?;~svqwl?wNqvYnZG=As3o1y<gs#z|
z4Z$O1hzURo0$(4s=O+6WEPlmw60E5ZrJh#(9)FYo;4UIoK^c0JzUOB4Sk!l{?pAP7
zvRU_Zfgk}0LJ)v!0$4DhVIJI^*?qS^(S3~W^XR@X?fMSytEb<T>Yt@Y*NxAuVPsW`
z-%)(Wr9tBFIF~sEhHuX4YrpTwC=k14PNCq`3#O4o|4i28-ny(lbEa~8N<{d~ne^!{
ztMtsKzP%vuK=<&FN6xn-%W?I$62ly%Os(7f1*}@iXIVxE7FkH9&MM5Aigy`|3n~|H
z4Har-eq3^%IoRt`rkM}F(<)Cca++)-BTNH%B3yyyd${F!Ugdj!7yH{GI<Nsp{4ME#
zMc?BLs4yZkn%?{76}O^Kbo4_udPOtahcH4hF(L6WTm7HbHE{9JN!lA#$%-^u%7=_h
z2NtD{Or2GqQ^KWZ*bk$ISO?mDdfI)xz+pA<ZBc7vZ;U%Kj$cQ<0Qyn3L>(fh@x|xz
zGAm<kFz2*-n4UyUffH6h8Nr|Kyq>viTX@QD_+E2eLr8PZ!Tgs1(8CX~0?*)0HTG%A
ze`{v%QLi|;;+Dm!_Bul7<dbh~WM1#nLf2E-^s-Un%B|qmoi;VN%l=c89{6n@eA5NH
zlFSMcZT8*^h@v@Wo%;uN7P%fD1pkd`Wq*`l|3li@TD~vCp3`d9^1by<>jboNAAAI1
zUH=4zll*m3&uT*VWCCvW{qSIQO+7#+OWODGPOwS1^UqYO<A+mfOwadsne2o?|9)%`
z_@pEjOTTeG+ZLor!PPInvEpCh-+giUXT_+>fqXjQwgJOZh->y$RNsf&*WBDDV&+-^
zw>cwKFX;UQ=wS~Ijpf>B>@@<DwJcvHnjI#~Wtu8hRI{y0dU59;YfPUTHCj%7IF{6*
ziR5>2BflyxNL07Jb=|L;%}YxZaY!N8M=Cbo?nX2LSO_AmtF0#%c4rG@%0S9MrLzVL
zq_o0R$T>Leo~a0-nmkamN|0}NWe%HcU5GwcQ+r^o%;_r>Sz#E846iH@!?}yNVFYqM
z&DB79urhCy+zOQ-ScNmR6-w)QD_E)iq%SgUw-aN$2CHk86}rLmqKqNBf<r#i%dx!!
zABC(#+tnqmA;Du7V9G;?l4>|3|3*}>oxQuAM~Qfqxse?SH`9kK;G0$)Z(6rn<u>e^
zE2pRZ<FQZb1~qX=<R~re_Qc7-Lbt7uneHruWc}r&tkl8GFXK%4Mhi!VTHc9F+mv>{
zR;$QDSJr>Z@7F4i_j*O|Q<M#`X81o+w1*FFzP8@H+`Ddiu*zC|!3xq1B-l9JmV}Cv
zMLxrl<=Zf?I={8D%Q6ntau<^_A2V|upOd~I`zBNvbxVOR`#MyF_@lQAG}GD5<VcSz
z>*dA1-h~XqOBhU)I2|{ZYFS#E#%rV?S6`-5O7d?0frN;-qcg{8UcAu;W8<TGCf+%k
z9P2LmL_cTLJ@%k=sTEK+laW<>F%}bkBXG2@VtSk_$1@|}uX6Fqoh>y({pFg}w82Jq
zp#X0sLu(^LMOKRSj<0au#sb+Dop=jq;4K7(dRw|p4Wd{4{V`5atGhp?K<f3pw1Ot%
zoj0+aU`l%7%|9zz4K!_bmk;{I*4h2Q(=)3Ms+CmJ3>MGlYmyB3XJz1just<`es|5F
zUq0YJJ{fGqQ+Op_KL_GV_oe-xW@F}l3}-r)NAl=W9puS1(y%a0TZwi>Rg$?$fIgMk
zS~hm;J{MFBo96u1aVR-cLGGv`1@)RJAC>atDaq?++yd9Js)}X(R<?F=v#$3x9x7f=
zexIqE7IuP_C5k$XQ>}Tf*<6BSCF_f^k#WnUQOB8%aQnw?(2qUWHO$NDTb!ke&P1zn
zG$UM}wQx*ZjoMbO^}&ljO$iXIPTj>?Q}PrM+l1wXmC-soo@qZwqWC>(?pl`|g&y&r
zNsAx8%KM+`pXC$2|C#<X+5FEM>n|)WkPUAIL|4J9adZ8%{NF-UTu7hzC)?Y!!p5}b
z5Nn%YzTfBvFzuc1^YrUbiG(Lw*Jh2ZCFVV*u)MzRc)#^g40@*+E_69(V{{AC4POGY
zf>#*kU35kV#jv5MZYgIxgAAB=2J>>jVSg#ddwqKei<?1guIyCsMV;rtcNKhN8?=Z>
z4q{%Oan6EfM1duLHR1I+{a_gVyI>s70nha=E)-U5vqe_=c*1l!*OdTlErA|tIOt9e
zNyjs&fi7U_dDzk%d_`=&SnJmT6(aTy5rx(Ut2<#g-+(CrV8DJue-XF{j)0#)A*F2g
z3;`y^{dZrjflD`SmM)G0D<%eMf%yy_-n5wQQLO4oG<aMPzOt484C#Qlv>C`w$H*fd
zd0VjwfCo~)ZGepyfwKZ*|8}6UcnC*;c?)oL0&v8nOAb0HRvo;M;eo*Nb{qzi4%+be
zWIPuLP0~p`E*^)2VO725AaKjRRa!faM)1T89gkoP%5)Pvv1<hc<<$!9<~(9)X6Lno
zJm71~{_)oa4k@m{cfSa_oF^rV!w6uu;phZZC`h_|kaP-RV7B0{_gEp8^Qz^Nx4>h&
z5TiJ2RPJx>Lcw+gD~y?0I6Qbh5xA>BiD)p1OWwo~fP9l)5K`^xz@g?9Q?xdoeZBbC
z-mo!UbQrQ5>;T`$8wByD3<BWE#<!=l0+tsn0PSS}A6>$icxyx8RywP+4jhf}U7fQ*
znwX9YsHkIb;AU8Xbz0N{@5rTvZyp7^JA)8n<z}qFw;{HB7p`mIG7X!htD}y<sHNm-
zDXjfs;2SxxF+Fq)-qR31I%YB?2m9MF@mM}6J-ma@0kd;td63z-`quZI@T4GbyWi&1
zfcSe)g}*oF8?yWjEO0qV`Jo|st#t?lm~!unenXD{T1SQx%s|l@-P}2*d{=waAP*i1
zQe;FS1YTdb!i`-m1(8_)2rImDf<@NeFNP8<mG-w558?I2V2wr$m<<Z=i$d${l(tE>
zge`6Nmw|E->u>_KDkY0&$O?f^4bo!p#k-ros{y4k&y%d|@i=rjf2Yu<OecJF1LWP`
znwKnqUaMbG2l8x?73jY}1%e>u?`~h<@H-8Hv3xrfB0Gwqn>foo9lU*i#~y6Vz#|^I
zvOo(G(7*!A=Wqn<@dUn!gEhTt-I<Y_Y5zx%STx`OcH{7^)hO_dS?DehM?(z+VC_2;
z?5Ms{;I#AF;rNX;kVW3Z#|%A^@jmGwqGopTVM|wF*ewMRDcx9`FTb#xInL+(Q1kLA
zT4#hC#1Tl`rEPcw2uL+3p)w!^MnO?y-sIiE>;T+U5Ja3fo}nxR)LyMH3_f`RB=w&$
z)%uS2Q4kVv3APSHjlfnwY<Gmhrr8jico?4d9WoR?=vpN(HwjWd2$Zvm6$KngKZpQO
zc{lE`$y6hBoz@f-H7EgKFqr|R?XS^X6B=xCnpL#cFP;w6XxfX#8n`UOB7DtFP;}L?
zd<X`3C#XcZ*g*xiBjWDk1>2+q;9G+!R@=J-<ek2G1aybe_3$xcbROOxz9qy6VgMw{
z?yh;mAg$HP%)yV@Q&7EtoJG0RXu1yW-?uzOpmR~a^n-@dBx)szZmKk|G@2{Os3F9{
z(v7BRZwkT^U7kdDKI?Jbarb-|`IjT8e~c8}zyJB7clT+sPm_Hf_>b`bj4<$j02>BE
A-2eap

literal 0
HcmV?d00001


From e133565c3a1fce0456c5427a2ab6e2cb9a52dff0 Mon Sep 17 00:00:00 2001
From: trujillo-adam <ajosetru@gmail.com>
Date: Mon, 28 Apr 2025 19:32:12 -0700
Subject: [PATCH 06/12] new reference block reference page

---
 website/data/language-nav-data.json      |    4 +
 website/docs/language/block/resource.mdx | 1217 ++++++++++++++++++++++
 2 files changed, 1221 insertions(+)
 create mode 100644 website/docs/language/block/resource.mdx

diff --git a/website/data/language-nav-data.json b/website/data/language-nav-data.json
index 7a8885c2c398..3a48ee944f3d 100644
--- a/website/data/language-nav-data.json
+++ b/website/data/language-nav-data.json
@@ -1115,6 +1115,10 @@
   {
     "title": "Configuration blocks",
     "routes": [
+      {
+        "title": "resource",
+        "path": "block/resource"
+      },    
       {
       "title": "check",
       "path": "block/check"
diff --git a/website/docs/language/block/resource.mdx b/website/docs/language/block/resource.mdx
new file mode 100644
index 000000000000..295d4a61429d
--- /dev/null
+++ b/website/docs/language/block/resource.mdx
@@ -0,0 +1,1217 @@
+---
+page_title: resource block reference
+description: >-
+   Learn configure `resource` block arguments in Terraform configuration language.
+---
+
+# `resource` block
+
+The `resource` block defines a piece of infrastructure and specifies the settings for Terraform to create it with. The arguments that an individual resource supports are determined by the provider. Refer to the provider documentation for more information about specific resource configuration.
+
+## Configuration model
+
+The `resource` block supports the following arguments:
+
+- [`resource "<TYPE>" "<LABEL>"`](#resource) &nbsp; block
+   - [Provider-specific arguments](#provider-specific-arguments) &nbsp; block | refer to your provider documentation
+   - [`count`](#count) &nbsp; number | mutually exclusive with `for_each`
+   - [`depends_on`](#depends_on) &nbsp; list of references
+   - [`for_each`](#for_each) &nbsp; map or set of strings | mutually exclusive with `count`
+   - [`provider`](#provider) &nbsp; reference
+   - [`lifecycle`](#lifecycle) &nbsp; block
+      - [`create_before_destroy`](#create_before_destroy) &nbsp; boolean
+      - [`prevent_destroy`](#prevent_destroy) &nbsp; boolean
+      - [`ignore_changes`](#ignore_changes) &nbsp; list of attributes
+      - [`replace_triggered_by`](#replace_triggered_by) &nbsp; list of references
+      - [`precondition`](#precondition) &nbsp; block
+        - [`condition`](#precondition) &nbsp; string
+        - [`error_message`](#precondition) &nbsp; string
+      - [`postcondition`](#postcondition) &nbsp; block
+        - [`condition`](#postcondition) &nbsp; string
+        - [`error_message`](#postcondition) &nbsp; string
+   - [`connection`](#connection) &nbsp; block
+        - [`type`](#connection-arguments) &nbsp; string
+        - [`user`](#connection-arguments) &nbsp; string
+        - [`password`](#connection-arguments) &nbsp; string
+        - [`host`](#connection-arguments) &nbsp; string
+        - [`port`](#connection-arguments) &nbsp; string
+        - [`timeout`](#connection-arguments) &nbsp; string
+        - [`script_path`](#connection-arguments) &nbsp; string
+        - [`private_key`](#connection-arguments) &nbsp; string
+        - [`certificate`](#connection-arguments) &nbsp; string
+        - [`agent`](#connection-arguments) &nbsp; string
+        - [`agent_identity`](#connection-arguments) &nbsp; string
+        - [`host_key`](#connection-arguments) &nbsp; string
+        - [`target_platform`](#connection-arguments) &nbsp; string
+        - [`script_path`](#connection-arguments) &nbsp; string
+        - [`https`](#connection-arguments) &nbsp; string
+        - [`insecure`](#connection-arguments) &nbsp; string
+        - [`use_ntlm`](#connection-arguments) &nbsp; string
+        - [`cacert`](#connection-arguments) &nbsp; string
+        - [`bastion_host`](#connection-arguments) &nbsp; string
+        - [`bastion_host_key`](#connection-arguments) &nbsp; string
+        - [`bastion_port`](#connection-arguments) &nbsp; string
+        - [`bastion_user`](#connection-arguments) &nbsp; string
+        - [`bastion_password`](#connection-arguments) &nbsp; string
+        - [`bastion_private_key`](#connection-arguments) &nbsp; string
+        - [`bastion_certificate`](#connection-arguments) &nbsp; string
+        - [`proxy_scheme`](#connection-arguments) &nbsp; string
+        - [`proxy_port`](#connection-arguments) &nbsp; string
+        - [`proxy_user_name`](#connection-arguments) &nbsp; string
+        - [`proxy_user_password`](#connection-arguments) &nbsp; string
+   - [`provisioner "<TYPE>" "<LABEL>"`](#provisioner) &nbsp; block
+      - [`source`](#source) &nbsp; string
+      - [`destination`](#destination) &nbsp; string
+      - [`content`](#content) &nbsp; string      
+      - [`command`](#command) &nbsp; string
+      - [`working_dir`](#working_dir) &nbsp; string
+      - [`interpreter`](#interpreter) &nbsp; string
+      - [`environment`](#command) &nbsp; string
+      - [`when`](#when) &nbsp; keyword
+      - [`quiet`](#quiet) &nbsp; boolean
+      - [`inline`](#inline) &nbsp; list of strings
+      - [`script`](#script) &nbsp; string
+      - [`scripts`](#scripts) &nbsp; string
+      - [`on_failure`](#on_failure) &nbsp; keyword
+      - [`connection`](#connection) &nbsp; block
+
+## Complete configuration
+
+The following `resource` block defines all of the supported built-in arguments you can set on a resource:
+
+```hcl
+resource "<TYPE>" "<LABEL>" {
+  <PROVIDER_ARGUMENTS>
+  count = <NUMBER>      # `for_each` and `count` are mutually exclusive 
+  depends_on = [ <RESOURCE.ADDRESS.EXPRESSION> ]
+  for_each = {          # `for_each` and `count` are mutually exclusive 
+    <KEY> = <VALUE>
+  }
+  for_each = [	     # `for_each` accepts a map or a set of strings 
+    "<VALUE>", 
+    "<VALUE>"
+  ]
+  provider = <REFERENCE.TO.ALIAS>
+  lifecycle {
+    create_before_destroy = <true || false>
+    prevent_destroy = <true || false>
+    ignore_changes = [ <ATTRIBUTE> ]
+    replace_triggered_by = [ <RESOURCE.ADDRESS.EXPRESSION> ]
+    precondition {
+      condition = <EXPRESSION>
+      error_message = "<STRING>"
+    }
+    postcondition {
+      condition = <EXPRESSION>
+      error_message = "<STRING>"
+    }
+  }
+  connection {
+    type = <"ssh" or "winrm">
+    host = <EXPRESSION>
+    <DEFAULT_CONNECTION_SETTINGS>
+  }
+  provisioner "<TYPE>" "<LABEL>" {
+    source = "<PATH>"
+    destination = "<PATH>"
+    content = "<CONTENT TO COPY TO `destination`>"
+    command = <COMMAND>
+    working_dir = "<PATH TO DIR WHERE TERRAFORM EXECUTES `command`>"
+    interpreter = [
+      "<PATH TO INTERPRETER EXECUTABLE>",
+      "<COMMAND> <ARGUMENTS>"
+    ]
+    environment {
+      "<KEY>" = "<VALUE>"
+    }
+    when = <TERRAFORM COMMAND>
+    quiet = <true || false>
+    inline = [ "<COMMAND>" ]
+    script = "<PATH>"
+    scripts = [
+      "<PATH>"
+    ]
+    on_failure = <continue || fail>
+    connection {
+      type = <"ssh" or "winrm">
+      host = <EXPRESSION>
+      <SPECIFIC_CONNECTION_SETTINGS>
+    }
+  }
+}
+```
+
+## Specification
+
+A `resource` block supports the following configuration. 
+
+### `resource "<TYPE>" "<LABEL>"`
+
+You must set the following arguments for every `resource` block: 
+
+- `TYPE`: Specifies the type of resource. This value is determined by the provider developer. Refer to provider documentation for details. The `terraform_data` resource type, which you can use to store values and trigger Terraform operations without creating actual infrastructure, is the exception. 
+- `LABEL`: Specifies a name for the resource. Terraform uses this label to track the resource in your state file. To reference the resource in your configuration, you must refer to it using `<TYPE>.<LABEL>` syntax. The label does not affect settings on the actual infrastructure resource. Refer to [References to Named Values](/terraform/language/expressions/references) and [Resource naming](/terraform/language/style#resource-naming) for expression syntax and label recommendations.
+
+### Provider-specific arguments
+
+The provider developer determines which arguments you can define for a resource. Refer to the provider documentation for details.  
+
+### `count`
+
+The `count` meta-argument instructs Terraform to provision multiple instances of the same resource with identical or similar configuration. 
+
+```hcl
+resource {
+  count = <number>
+}
+```
+
+The value must be a whole number. You can reference variables or local values and use expressions to compute the value, but the value must resolve to a whole number. 
+
+In blocks where `count` is set, Terraform exposes an additional `count` object. You can reference the object to modify the configuration of each instance. The `count` object has an `index` attribute starting from `0`. 
+
+To refer to an individual instance of a resource created using the `count` meta-argument, use the `<TYPE>.<NAME>[INDEX]` syntax. For example, `aws_instance.server[0]` refers to the first instance of the `aws_instance` resource named `server`. 
+
+<Tip>
+
+You can use the `count` argument as a conditional for creating resources. For example, setting a `count = var.creator ? 3 : 0` instructs Terraform to create three instances of the resource when a variable named `creator` is set to `true`. Refer to [​​Conditional Expressions](/terraform/language/expressions/conditionals) for additional information.
+
+</Tip>
+
+The `count` argument is a meta-argument, which is built into Terraform and controls the way that Terraform creates resources. Refer to [Meta-arguments](/terraform/language/meta-arguments) for additional information.
+
+#### Summary
+
+- Data type: Number. 
+- Default: None.  
+- Example: [Create multiple instances of a resource](#create-multiple-instances-of-a-resource).
+
+### `depends_on`
+
+The `depends_on` meta-argument specifies an upstream resource that the resource depends on. Terraform must complete all operations on the upstream resource before performing operations on the resource containing the `depends_on` argument.
+
+```hcl
+resource {
+  depends_on = [ <resource reference> ]
+}
+```
+
+When a resource configuration refers to another resource, Terraform identifies the dependency and creates the upstream resource first. In some cases, you may need Terraform to create a resource before creating another, even though the resources are configured independently. 
+
+Use the `depends_on` argument when Terraform cannot infer a dependency automatically. We recommend always including a comment to explain resource dependencies when using a `depends_on` argument.
+
+When using the `depends_on` meta-argument, you can only reference other resources or child modules in the same root module. The list cannot include arbitrary expressions. Any values referenced in the `depends_on` list must be known before Terraform begins the operation so that it can evaluate dependencies.
+
+Specifying an entire module in the `depends_on` argument affects the order in which Terraform provisions all of the resources and data sources associated with that module. Refer to [Resource dependencies](/terraform/language/manage-resources#resource-dependencies) <!-- placeholder link -->
+and [Data resource dependencies](/terraform/language/configure-data-sources#data-resource-dependencies) for additional information.
+
+The `depends_on` argument is a meta-argument, which is built into Terraform and controls the way that Terraform creates resources. Refer to [Meta-arguments](/terraform/language/concepts/meta-arguments) for additional information.
+
+#### Summary
+
+- Data type: List.
+- Default: None.  
+- Example: [Specify a dependency](#specify-a-dependency). 
+
+### `for_each`
+
+The `for_each` meta-argument instructs Terraform to provision similar resources without requiring separate configuration blocks for each resource. 
+
+<Tabs>
+
+<Tab heading="List of values">
+
+```hcl
+resource {
+  for_each = [ "<VALUE>" ] 
+  # . . .
+}
+```
+
+</Tab>
+
+<Tab heading="Map of key-value pairs">
+
+```hcl
+resource {
+  for_each = {
+    "<KEY>" = "<VALUE>"
+  }
+}
+```
+
+</Tab>
+
+</Tabs>
+
+The `for_each` meta-argument accepts a map or a set of strings and creates an instance for each item in that map or set. Each instance is associated with a distinct infrastructure object. Terraform creates, updates, or destroys each instance when applying changes to the configuration.
+
+You can use pure functions, such as `toset()` and `tomap()`, to create a map or set for use in the `for_each` argument. Whether iterating over the keys of a map or set of strings, all must be known values. Otherwise, Terraform prints an error message that `for_each` has dependencies that it cannot determine before applying the configuration.
+
+Keys in the `for_each` argument cannot be the result of or rely on the result of impure functions, including `uuid`, `bcrypt`, or `timestamp`, because Terraform defers evaluating impure functions during the main evaluation step.
+
+The `for_each` argument does not implicitly convert lists or tuples to sets. To declare resource instances based on a nested data structure or combinations of elements from multiple data structures, you can use Terraform expressions and functions to derive a suitable value. Refer to the following examples for additional information:
+
+- [Transform a multi-level nested structure into a flat list](/terraform/language/functions/flatten#flattening-nested-structures-for-for_each)
+- [Combine collections to produce a list of element combinations](/terraform/language/functions/setproduct#finding-combinations-for-for_each).
+
+You cannot use sensitive values, such as [sensitive input variables](/terraform/language/values/variables#suppressing-values-in-cli-output), [sensitive outputs](/terraform/language/values/outputs#sensitive-suppressing-values-in-cli-output), or [sensitive resource attributes](/terraform/language/expressions/references#sensitive-resource-attributes), as arguments in `for_each`. Terraform uses the value in `for_each` to identify the resource instance and always discloses it in UI output, so sensitive values are not allowed. Terraform returns an error if you attempt to use sensitive values as `for_each` arguments.
+
+If you transform a value containing sensitive data into an argument for use in `for_each`, be aware that most functions in Terraform will return a sensitive result if given an argument with any sensitive content. In many cases, you can achieve similar results with a `for` expression. For example, to call `keys(local.map)` where `local.map` is an object with sensitive values, but non-sensitive keys, you can create a value to pass to `for_each` using `toset([for k,v in local.map : k])`.
+
+Refer to [Sensitive Data in State](/terraform/language/state/sensitive-data) for additional information. 
+
+The `for_each` argument exposes an `each` object that you can reference within the same block to modify specific instances of the resource. The object has the following attributes:
+
+- `each.key`: Map key or list member that corresponds to an instance.
+- `each.value`: Map value that corresponds to an instance. 
+
+Use the `<TYPE>.<NAME>[<KEY>]` syntax to access an instance of a resource created using `for_each`. For example, `azurerm_resource_group.rg["a_group"]` refers to an instance of the `azurrm_resource_group` resource named `rg` created off of the `a_group` key.
+
+The `for_each` argument is a meta-argument, which is built into Terraform and controls the way that Terraform creates resources. Refer to [Meta-arguments](/terraform/language/meta-arguments) for additional information.
+
+#### Summary
+
+- Data type: Map or set of strings.
+- Default: None.  
+- Example: [Create multiple instances of a resource](#create-multiple-instances-of-a-resource). 
+
+### `provider`
+
+The `provider` argument instructs Terraform to use an alternate provider configuration to provision the resource. 
+
+```hcl
+resource {
+  provider = <provider>.<alias>
+}
+```
+
+By default, Terraform automatically selects a provider based on the resource type, but you can create multiple provider configurations and use a non-default configuration for specific resources. 
+
+Use the `<PROVIDER>.<ALIAS>` syntax to reference a provider configuration in the `provider` argument. Refer to [Multiple Provider Configurations](/terraform/language/providers/configuration#alias-multiple-provider-configurations) for instructions on how to reference a specific provider configuration.     
+
+The `provider` argument is a meta-argument, which is built into Terraform and controls the way that Terraform creates resources. Refer to [Meta-arguments](/terraform/language/concepts/meta-arguments) for additional information.
+
+#### Summary
+
+- Data type: Reference.
+- Default: None. 
+- Example: [Select an alternate provider configuration](#select-an-alternate-provider-configuration).
+
+### `lifecycle`
+
+The `lifecycle` block defines lifecycle rules that instruct Terraform when and how to operate on your resource. 
+
+```hcl
+resource {
+  lifecycle { 
+    <lifecycle>
+  }
+}
+```
+
+You can specify the following lifecycle rules to manage how Terraform performs operations on the resource:
+
+- [`create_before_destroy`](#create_before_destroy): Terraform creates a replacement resource before destroying the previous resource.
+- [`prevent_destroy`](#prevent_destroy): Terraform rejects operations to destroy the resource and returns an error.
+- [`ignore_changes`](#ignore_changes):  Specifies a list of resource attributes that, when modified outside of your configuration, Terraform ignores instead of attempting to update the actual resource to match the configuration.  
+- [`replace_triggered_by`](#replace-triggered_by): Terraform replaces the resource when any of the referenced resources or attributes specified change.
+- [`precondition`](#precondition): Specifies a condition that Terraform evaluates before creating the resource. Refer to [Test and validate](/terraform/language/test-and-validate) for additional information.
+- [`postcondition`](#postcondition): Specifies a condition that Terraform evaluates after creating the resource. Refer to [Test and validate](/terraform/language/test-and-validate) for additional information.
+
+Configurations defined in the `lifecycle` block affect how Terraform constructs and traverses the dependency graph. You can only use literal values in the lifecycle block because Terraform processes them before it evaluates arbitrary expressions for a run.
+
+The `lifecycle` block is a meta-argument. Meta-arguments are built-in arguments that control how Terraform creates resources. Refer to [Meta-arguments](/terraform/language/concepts/meta-arguments) for additional information.  
+
+#### Summary
+
+- Data type: Block.
+- Default: None 
+
+### `create_before_destroy`
+
+The `create_before_destroy` argument instructs Terraform to create a replacement resource before destroying the resource it replaces. 
+
+```hcl
+resource {
+  lifecycle { 
+    create_before_destroy = <boolean>
+  }
+}
+```
+
+By default, Terraform destroys a resource before creating a replacement. 
+
+Refer to the documentation for the resource type you are configuring to understand which changes Terraform can make in-place and which require recreating the resource to decide whether to use the `create_before_destroy` argument. 
+
+Terraform propagates and applies the `create_before_destroy` behavior to all upstream resources. For example, if `create_before_destroy` is enabled on resource A but not on resource B, but resource A is dependent on resource B, then Terraform enables `create_before_destroy` for resource B implicitly and records it in the state file. You cannot override `create_before_destroy` to `false` on resource B because that would imply dependency cycles in the graph.
+
+Setting`create_before_destroy` to `true` on a resource stops any configured destroy provisioners. 
+
+#### Summary
+
+- Data type: Boolean
+- Default: None. 
+
+### `prevent_destroy`
+
+The `prevent_destroy` argument instructs Terraform to reject plans to destroy the resource.
+
+```hcl
+resource {
+  lifecycle { 
+    prevent_destroy = <boolean>
+  }
+}
+```
+
+Use this argument to prevent team members from accidentally replacing critical infrastructure, such as database instances.
+
+When the `prevent_destroy` argument is set, you must either remove the resource from the configuration or change the `prevent_destroy` argument to `false` to destroy it. Use this argument with caution. The `prevent_destroy` argument can make applying resource changes or destroying resources more complex. 
+
+#### Summary
+
+- Data type: Boolean.
+- Default: None.  
+
+### `ignore_changes`
+
+The `ignore_changes` argument specifies a list of resource attributes for Terraform to ignore when planning updates to the resource. 
+
+```hcl
+resource {
+  lifecycle { 
+    ignore_changes = [ <attribute> ]
+  }
+}
+```
+
+Use this argument when the resource references data that may change but does not affect the resource after its creation. 
+
+By default, Terraform detects any difference in the current settings of a real infrastructure object and plans to update the remote object to match the configuration.
+
+Terraform uses the specified arguments to create a resource, but ignores them when planning an `update` operation. You can specify arguments as the relative attribute addresses in the resource and reference members of maps and lists using index notation, such as `tags["Name"]` and `list[0]`. 
+
+You can also specify `all` instead of a list to ignore future changes to all resource attributes. This lets Terraform create and destroy the resource but it does not propose updates to it. 
+
+#### Summary
+
+- Data type: List.
+- Default: None. 
+- Example: [Ignore attribute changes](#ignore-attribute-changes).
+
+### `replace_triggered_by`
+
+The `replace_triggered_by` argument instructs Terraform to replace the resource when any of the referenced items change.
+
+```hcl
+resource {
+  lifecycle { 
+    replace_triggered_by = [ <address.reference> ]
+  }
+}
+```
+
+You can specify a list of expressions that reference managed resources, instances, or instance attributes. You can only reference managed resources in `replace_triggered_by` expressions. This lets you modify these expressions without forcing replacement.
+
+The trigger is based on the planned actions for all of the given resources. Terraform does not plan actions for plain values, such as local values or input variables, but you can use the `terraform_data` resource type to apply a resource-like lifecycle to them.
+
+References in the argument list trigger a replacement under following conditions:
+
+- When referencing a resource with multiple instances, such as those created by `count` or `for_each`, a `terraform plan` command to update or replace any instance triggers replacement.
+- When referencing a single resource instance, a `terraform plan` command to update or replace that instance triggers replacement.
+- When referencing a single attribute of a resource instance, any change to the attribute value triggers replacement.
+
+Adding the `replace_triggered_by` argument to a resource that uses `count` or `for_each` lets you add the `count.index` or `each.key` resource address to the expression. Use this address segment to reference specific instances of other resources that are configured with the same `count` or collection.
+
+#### Summary
+
+- Data type: List 
+- Default: None.
+- Example: [Specify triggers that replace resources](#specify-triggers-that-replace-resources)  
+
+### `precondition`
+
+The `precondition` block specifies a condition that must return `true` before Terraform evaluates and performs operations on the resource. You can also specify an error message for Terraform to print when the condition returns `false`. 
+
+```hcl
+resource {
+  lifecycle { 
+    precondition {
+      condition = <expression>
+      error_message = "<message>"
+    }
+  }
+}
+```
+
+The following arguments in the `precondition` block are required:
+
+| Argument | Description | Data type |
+| --- | --- | --- |
+| `condition` | Expression that must return `true` for Terraform to proceed with an operation. You can refer to any other object in the same configuration scope unless the reference creates a cyclic dependency. | Expression that can include references, strings, and operators. |
+| `error_message` | Message that Terraform prints to the console if the `condition` returns `false`. | String |
+
+Terraform evaluates `precondition` blocks before evaluating the resource's configuration arguments. The `precondition` can take precedence over argument evaluation errors.
+
+Terraform evaluates precondition blocks after evaluating `count` and `for_each` meta-arguments. As a result, Terraform can evaluate the `precondition` separately for each instance and makes the `each.key` and `count.index` objects available in the conditions. 
+
+You can include a `precondition` and [`postcondition` block](#postcondition) in the same resource. Do not add `precondition` blocks to a `resource` block and a `data` block that represent the same object in the same configuration. Doing so can prevent Terraform from understanding that the data block result can be affected by changes in the resource block. 
+
+Refer to [Test and validate](/terraform/language/test-and-validate) for information about adding validations to your Terraform configuration.
+
+#### Summary
+
+- Data type: Block.
+- Default: None.
+- Example: [Apply custom conditions](#apply-custom-conditions)
+
+### `postcondition`
+
+The `postcondition` block specifies a condition that must return `true` after Terraform performs operations on the resource. You can also specify an error message for Terraform to print to the console when the condition returns `false`. 
+
+```hcl
+resource {
+  lifecycle { 
+    postcondition {
+      condition = <expression>
+      error_message = "<message>"
+    }
+  }
+}
+```
+
+The following arguments in the `precondition` block are required:
+
+| Argument | Description | Data type |
+| --- | --- | --- |
+| `condition` | Expression that must return `true` for Terraform to perform operations on downstream resources. You can refer to any other object in the same configuration scope unless the reference creates a cyclic dependency. | Expression that can include references, strings, and operators. |
+| `error_message` | Message that Terraform prints to the console if the `condition` returns `false`. | String |
+
+Refer to [Test and validate](/terraform/language/test-and-validate) for information about adding validations to your Terraform configuration.
+
+Terraform evaluates `postcondition` blocks after planning and applying changes to the resource. Postcondition failures prevent changes to other resources that depend on the failing resource.
+
+You can include a `postcondition` and [`precondition` block](#precondition) in the same resource. Do not add `postcondition` blocks to a `resource` block and a `data` block that represent the same object in the same configuration. Doing so can prevent Terraform from understanding that the data block result can be affected by changes in the resource block. 
+
+#### Summary
+
+- Data type: Block.
+- Default: None.
+- Example: [Apply custom conditions](#apply-custom-conditions)
+
+### `connection`
+
+The `connection` block specifies settings that let provisioners connect to resources so that Terraform can perform operations on the resource after creating it.
+
+<Warning>
+
+We recommend using configuration management tools or other means to perform actions on the local or remote machine instead of using provisioners. Refer to [Perform post-apply action](#)<!--TODO: updated with real link when ready--> for additional information.
+
+</Warning>
+
+You can add the `connection` block to either the [`resource`](#resource) block or the [`provisioner`](#provisioner) block. When added to the `resource` block, the `connection` block sets default connection settings for all provisioners defined in the resource so that provisioners can connect to the remote resource after Terraform provisions it. 
+
+```hcl
+resource {
+  # . . .
+  connection {
+    <settings for all provisioners in the resource>
+  }
+}
+```
+
+When added to a `provisioner` block, the `connection` block defines settings specific to the provisioner.
+
+```hcl
+resource {
+  # . . .
+  provisioner {
+    # . . .
+    connection {
+      <settings for all provisioners in the resource>
+    }
+  }
+}
+```
+
+Terraform does not validate SSH host keys by default. You can establish a separate mechanism for key distribution and explicitly set the `host_key` argument to verify against a specific key or signing CA.
+
+You can use ephemeral values for arguments in the `connection` block. Refer [Ephemerality in resources](/terraform/language/resources/ephemeral) for additional information.
+
+Expressions in `connection` blocks cannot refer to their parent resource by name. References create dependencies, and referring to a resource by name within its own block would create a dependency cycle. Instead, use the `self` object in expressions to refer to the `connection` block's parent block, including all of its attributes. For example, use `self.public_ip` to reference the `public_ip` attribute in an `aws_instance`. 
+
+<span id="connection-arguments"/>
+
+<Tip>
+
+You can provide multiple connections so that an initial provisioner can connect as the root user to set up user accounts and subsequent provisioners can connect as less-privileged users to perform more specific operations.
+
+</Tip>
+
+The following table describes the arguments you can use in the `connection` block:
+
+| Argument | Description | Data type | Connection | Default |
+|---------------|--------------|-------------|---------| --- | 
+| `type` | Specifies the type of connection for sending and receiving data from the remote resource. You can specify `ssh` or `winrm`. When set to `winrm`, provisioners implement Windows-specific behaviors, even when `target_platform` is set to `unix`, unless otherwise specified.| string |  | `ssh` |
+| `user` | Specifies the user to use for the connection. | string | `ssh`<p>`winrm`</p> | <p>`root` when `type` is `ssh`</p><p>`Administrator` when `type` is `winrm`</p> | 
+| `password` | Specifies the password to use for the connection. | string | `ssh`<p>`winrm`</p> | none |
+| `host` | Specifies the address of the resource to connect to. <p>This argument is required.</p> | string | `ssh`<p>`winrm`</p> | none |
+| `port` | Specifies the port number to connect to. | number | `ssh`<p>`winrm`</p> | <p>`22` when `type` is `ssh`</p><p>`5985` when `type` is `winrm`</p> |
+| `timeout` | Specifies how long to wait for the connection to become available. | string | `ssh`<p>`winrm`</p> | `"5m"` |
+| `script_path` | Specifies the path on the remote resource where Terraform copies scripts to. Refer to the [`provisioner` block reference](#provisioner) for additional information. Terraform copies scripts to a path that contains random numbers depending on the `target_platform` configuration. | string | `ssh`<p>`winrm`</p> | <p>`/tmp/terraform_%RAND%.sh` when `target_platform` is `unix`</p><p>`C:/windows/temp/`<br/>`terraform_%RAND%.cmd` when `target_platform` is `windows`</p> |
+| `private_key` | Specifies the contents of an SSH key to use for the connection. `private_key` takes precedence over `password` when both are provided. | <p>string</p><p>Use a [`file` function](/terraform/language/functions/file) to load keys from file.</p> | `ssh` | none |
+| `certificate` | Specifies the contents of a signed CA certificate. You must also configure a  `private_key` arugment. | <p>string</p><p>Use a [`file` function](/terraform/language/functions/file) to load certificates from file.</p> | `ssh` | none |
+| `agent` | Specifies an SSH agent for authentication. Set to `false` to disable using `ssh-agent` to authenticate. On Windows, the only supported SSH authentication agent is [Pageant](http://the.earth.li/\~sgtatham/putty/0.66/htmldoc/Chapter9.html#pageant). | string | `ssh` | `false` |
+| `agent_identity` | Specifies the preferred identity from the SSH agent to use for authentication. | string | `ssh` | none |
+| `host_key` | Specifies the public key from the remote host or the signing CA to verify the connection. | string | `ssh` | none |
+| `target_platform` | Specifies the target platform, which affects the default value for the `script_path` argument. You can specify either `windows` or `unix`. <p>`windows` sets the default `script_path` to `c:\windows\temp\terraform_%RAND%.cmd` if the default SSH shell on the remote resource is `cmd.exe`. Refer to the [Windows documentation](https://docs.microsoft.com/en-us/windows-server/administration/openssh/openssh_server_configuration#configuring-the-default-shell-for-openssh-in-windows) for additional information. If the SSH default shell is PowerShell, set `script_path` to `"c:/windows/temp/terraform_%RAND%.ps1"`.</p><p>`unix` sets the default `script_path` to `/tmp/terraform_%RAND%.sh`. </p> | string | `ssh` |`unix` |
+| `https` | Set to `true` to connect using HTTPS instead of HTTP. | boolean | `winrm` | `false` |
+| `insecure` | Set to `true` to skip validating the HTTPS certificate chain. | boolean | `winrm` | `false` |
+| `use_ntlm` | Set to `true` to use NTLM authentication instead of basic authentication. Using NTLM removes the requirement for basic authentication to be enabled within the target guest. Refer to [Authentication for Remote Connections](https://docs.microsoft.com/en-us/windows/win32/winrm/authentication-for-remote-connections) in the Windows App Development documentation for more details. | boolean | `winrm` | `false` |
+| `cacert` | Specifies the CA certificate to validate against. | string | `winrm` | none |
+| `bastion_host` | Specifies the address of the bastion host. The provisioner connects to `bastion_host` before connecting to `host`. | string | `ssh` | none |
+| `bastion_host_key` | Specifies the public key from the remote host or the signing CA to verify the host connection. | string | `ssh` | none |
+| `bastion_port` | Specifies the port number to use for the bastion host connection. | string | `ssh` | value of the `port` field|
+| `bastion_user`| Specifies the user name for connecting to the bastion host. | string | `ssh` | value of the `user` field |
+| `bastion_password` | Specifies the user password for connecting to the bastion host. | string | `ssh` | value of the `password` field |
+| `bastion_private_key` | Specifies the contents of an SSH key file to use for the bastion host. | <p>string</p><p>Use a [`file` function](/terraform/language/functions/file) to load keys from file.</p> | `ssh` | value of the `private_key` field |
+| `bastion_certificate` |  Specifies the contents of a signed CA certificate. You must also configure the `bastion_private_key` argument when providing the certificate for the bastion host. | <p>string</p><p>Use a [`file` function](/terraform/language/functions/file) to load certificates from file.</p> | `ssh` | value of the `certificate` field |
+| `proxy_scheme` | Specifies the connection protocol. You can specify one of the following values: <li>`http`</li><li>`https`</li><li> `socks5`</li> | string | `ssh` | none |
+| `proxy_host` | Specifies the address of the proxy host. The provisioner connects to the proxy host first. When `bastion_host` is configured, the provisioner connects to the bastion host next, otherwise the provisioner connects to the host specified in the `host` argument.  | string | `ssh` | none |
+| `proxy_port` | Specifies the port number to use for the proxy host connection. | number | `ssh` | none |
+| `proxy_user_name` | Specifies the user name for connecting to the proxy host. You should only configure this argument when the proxy server requires authentication. | string | `ssh` | none |
+| `proxy_user_password` | Specifies the user password for connecting to the proxy host. You should only configure this argument when the proxy server requires authentication. | string | `ssh` | none |
+
+#### Summary
+
+- Data type: Block.
+- Default: None.
+- Example: [Connect to remote resources](#connect-to-remote-resources)
+
+### `provisioner`
+
+The `provisioner` block defines actions to perform on the local machine or created resource, such as preparing servers or other infrastructure objects for service. 
+
+```hcl
+resource {
+  provisioner "<TYPE>" "<LABEL>" {
+    <arguments> 
+  }
+}
+```
+
+<Warning>
+
+We recommend using configuration management tools or other means to perform actions on the local or remote machine instead of using the `provisioner` block. Refer to [Perform post-apply action](#)<!--TODO: updated with real link when ready--> for additional information.
+
+</Warning>
+
+The `provisioner` block supports the following arguments:
+
+- `TYPE`: Specifies the type of provisioner to use. You must specify one of the following types:   
+  - `file`: Copies files or directories from the machine where Terraform is running to the new resource. When the file provisioner communicates with a Windows system over SSH, you must configure OpenSSH to run the commands with `cmd.exe` and not PowerShell. PowerShell causes file parsing errors because it is incompatible with both Unix shells and the Windows command interpreter.
+  - `local-exec`: Invokes an executable on the local machine after Terraform creates the resource.
+  - `remote-exec`: Invokes an executable on the remote resource after Terraform creates the resource.  
+- `LABEL`: Optional attribute for adding a unique name. Refer to [Resource naming](/terraform/language/style#resource-naming) for label recommendations.
+
+The type of provisioner determines which arguments you can add to the block. All types can use the [`connection`](#connection) argument. The following table lists each type's supported arguments:
+
+| Provisioner type | Arguments |
+| --- | --- |
+| `file` | <li>[`source`](#source)</li><li>[`content`](#content)</li><li>[`destination`](#destination)</li> |
+| `local-exec` | <li>[`command`](#command)</li><li>[`working_dir`](#working_dir)</li><li>[`interpreter`](#interpreter)</li><li>[`environment`](#command)</li><li>[`when`](#when)</li><li>[`quiet`](#quiet)</li> |
+| `remote-exec` | <li>[`inline`](#inline)</li><li>[`script`](#script)</li><li>[`scripts`](#scripts)</li> |
+| All types | <li>[`connection`](#connection)</li> <li>[`on_failure`](#on_failure)</li> |
+
+#### Summary
+
+- Data type: Block.
+- Default: None.
+
+### `source`
+
+The `source` specifies the location of a file or directory to copy to the location specified in the [`destination`](#destination) argument. 
+
+```hcl
+resource {
+  provisioner "file" "<LABEL>" {
+    source = "<path>"
+  }
+}
+```
+
+
+You can specify a string value that contains an expression. You can't use the `source` argument and the [`content`](#content) argument in the same `provisioner "file"` block. 
+
+When the `source` argument specifies a directory and the `type` argument in the [provisioner connection settings](#connection) is set to `ssh`, the corresponding directory specified in the `destination` argument must already exist. You can add a `provisioner "remote-exec"` block to your `resource` configuration to create the directory. If the directory does not already exist, Terraform creates it when the `type` argument in the [provisioner connection settings](#connection) is set to `winrm`.
+
+Adding a trailing slash to the `source` argument path instructs Terraform to copy the contents of the directory to the `destination` directory. For example, when `source = "/foo/"` and `destination = "/temp"`, Terraform uploads the contents of `/foo` directory into `/tmp`. 
+
+Without a trailing slash, Terraform creates the directory under the directory specified in the `destination`. For example, when `source = "/foo"` and `destination = "/temp"`, Terraform uploads the `/foo` directory to `/tmp/foo`. 
+
+#### Summary
+
+- Data type: String.
+- Default: None.
+- Example: [Copy content to new resources](#copy-content-to-new-resources).
+
+### `content`
+
+The `content` argument specifies content to write directly to the location specified in the [`destination`](#destination) argument. 
+
+```hcl
+resource {
+  provisioner "file" "<LABEL>" {
+    content = "<content>"
+  }
+}
+```
+
+
+When `destination` points to a file, Terraform writes the value of the `content` argument to the file. When `destination` points to a directory, Terraform creates a file named `tf-file-content` inside the directory. We recommend setting the `destination` argument to a file when using `content` argument. Do not use the `content` argument and the [`source`](#source) argument in the same `provisioner "file"` block. 
+
+You can specify a string value that contains an expression. You can't use the `source` argument and the [`content`](#content) argument in the same `provisioner "file"` block. 
+
+#### Summary
+
+- Data type: String.
+- Default: None.
+- Example: [Copy content to new resources](#copy-content-to-new-resources).
+
+### `destination`
+
+The `destination` argument specifies a path on the remote resource that Terraform copies content to. You can use either [`source`](#source) or [`content`](#content) argument to provide content to the `destination` path. 
+
+```hcl
+resource {
+  provisioner "file" "<LABEL>" {
+    destination = "<path>"
+  }
+}
+```
+
+
+The remote system, not Terraform, evaluates the path you provide in the `destination` argument. As a result, valid values can vary depending on the operating system and remote access software running on the target.
+
+When the `type` argument in the [provisioner connection settings](#connection) is set to `ssh`, the provisioner passes the destination path as-is to the `scp` program on the remote host. By default, the OpenSSH `scp` implementation runs in the remote user's home directory. As a result, you can specify a relative path to upload into the home directory or an absolute path to upload to a different location. 
+
+The remote `scp` process runs with the access level of the user specified in the [provisioner connection settings](#connection), so permissions may prevent Terraform from writing directly to locations outside of the home directory.
+
+When the `type` argument in the [provisioner connection settings](#connection) is set to `winrm`, Terraform uses PowerShell to interpret the `destination` path. As a result, you must not use meta-characters that PowerShell might interpret. You should specifically avoid including untrusted external input in your `destination` argument because doing so can let arbitrary PowerShell code execute on the remote system. 
+
+Terraform performs the following process over WinRM connections:
+
+1. Generates a temporary filename in the directory set in the remote system's `TEMP` environment variable. 
+1. Generates a sequence of `echo` commands to gradually append base64-encoded chunks of the source file to the temporary file.
+1. Uses an uploaded PowerShell script to read the temporary file, base64-decode, and write the raw result into the destination file.
+
+Modern Windows systems support running an OpenSSH server, so we strongly recommend choosing SSH over WinRM.
+
+#### Summary
+
+- Data type: String.
+- Default: None.
+- Example: [Copy content to new resources](#copy-content-to-new-resources).
+
+### `command`
+
+The `command` argument specifies a command for a local executable to run. You can specify an absolute path or a relative path to the current working directory. 
+```hcl
+resource {
+  provisioner "local-exec" "<LABEL>" {
+    command = "<path>"
+  }
+}
+```
+
+Terraform evaluates the command in a local shell and can use environment variables for variable substitution. We do not recommend using Terraform variables for variable substitution because doing so can lead to shell injection vulnerabilities. Instead, you should pass Terraform variables to a command through the environment parameter and use environment variable substitution. Refer to the following OWASP article for additional information about injection flaws: [Code Injection](https://owasp.org/www-community/attacks/Code_Injection).
+
+#### Summary
+
+- Data type: String.
+- Default: None.
+- This argument is required in the `provisioner "local-exec"` block.
+- Example: [Invoke executables](#invoke-executables).
+
+### `working_dir`
+
+The `working_dir` block specifies the working directory where Terraform executes the command specified in the the [`command`](#command) argument. You can specify a relative path to the current working directory or an absolute path. The directory must already exist.
+
+```hcl
+resource {
+  provisioner "local-exec" "<LABEL>" {
+    working_dir = "<path>"
+  }
+}
+```
+
+#### Summary
+
+- Data type: String.
+- Default: None.
+- Example: [Invoke executables](#invoke-executables).
+
+### `interpreter`
+
+The `interpreter` block specifies a list of interpreter arguments for running the executable specified in the [`command`](#command) argument. 
+
+```hcl
+resource {
+  provisioner "local-exec" "<LABEL>" {
+    interpreter = [ "<path/to/interpreter>", "<command argument>" ]
+  }
+}
+```
+
+
+The first argument in the list is a path to the interpreter. You can specify a relative path to the current working directory or an absolute path. If you do not specify an interpreter, Terraform uses operating system defaults.
+
+#### Summary
+
+- Data type: List.
+- Default: None.
+- Example: [Invoke executables](#invoke-executables).
+
+### `environment`
+
+The `environment` block specifies a block of key value pairs that represent the environment for running the command specified in the [`command`](#command) argument. 
+
+```hcl
+resource {
+  provisioner "local-exec" "<LABEL>" {
+    environment {
+      <KEY> = <VALUE>
+    }
+  }
+}
+```
+
+#### Summary
+
+- Data type: Block.
+- Default: None.
+- Example: [Invoke executables](#invoke-executables).
+
+### `when`
+
+The `when` argument specifies a Terraform command that triggers actions specified in the provisioner. 
+
+```hcl
+resource {
+  provisioner "local-exec" "<LABEL>" {
+    when = <Terraform command>
+  }
+}
+```
+
+
+When you run the specified Terraform command, Terraform performs run the command specified in the [`command`](#command) argument. Refer to [Destroy-time provisioners](terraform/language/resources/provisioners/syntax#destroy-time-provisioners) for instructions on using the `when` argument.
+
+#### Summary
+
+- Data type: Terraform command.
+- Default: None.
+- Example: [Invoke executables](#invoke-executables).
+
+### `quiet`
+
+The `quiet` argument disables printing the [`command`](#command) argument's output to `stdout`.
+
+
+```hcl
+resource {
+  provisioner "local-exec" "<LABEL>" {
+    quiet = <boolean>
+  }
+}
+```
+
+When `quiet` is set to `true`, Terraform prints `"Suppressed by quiet=true"` to `stdout`. Terraform still prints the output of the command.
+
+
+#### Summary
+
+- Data type: Boolean.
+- Default: None.
+
+## Examples
+
+The following examples show how to write configuration for common use cases.
+
+### Define an AWS instance
+
+The following example defines an `aws_instance` resource named `web`. 
+
+```hcl
+resource "aws_instance" "web" {
+  ami           = "ami-a1b2c3d4"
+  instance_type = "t2.micro"
+}
+```
+
+### Create multiple instances of a resource
+
+You can use either `count` or the `for_each` block to create multiple instances of a resource. The `count` argument is most suitable for creating multiple instances that are identical or nearly identical. The `for_each` argument is most suitable for creating multiple similar instances that you capture and reference from a map or set.
+
+<Tabs>
+
+<Tab heading="count"> 
+
+The following example creates one instance for each subnet provided in the input variable:
+
+```hcl
+variable "subnet_ids" {
+  type = list(string)
+}
+
+resource "aws_instance" "server" {
+
+  count = length(var.subnet_ids)
+
+  ami           = "ami-a1b2c3d4"
+  instance_type = "t2.micro"
+  subnet_id     = var.subnet_ids[count.index]
+
+  tags = {
+    Name = "Server ${count.index}"
+  }
+}
+```
+
+</Tab>
+
+<Tab heading="for_each">
+
+The following example creates two instances that reference a map created using the `tomap()` function:
+
+```hcl
+resource "azurerm_resource_group" "rg" {
+  for_each = tomap({
+    a_group       = "eastus"
+    another_group = "westus2"
+  })
+  name     = each.key
+  location = each.value
+}
+```
+
+The following example creates four instances using a set created with the `toset()` function:
+
+```hcl
+resource "aws_iam_user" "the-accounts" {
+  for_each = toset(["Todd", "James", "Alice", "Dottie"])
+  name     = each.key
+}
+```
+
+In the following example, the `module` block creates an instance of the `publish_bucket` module for each element in the `for_each` set. It uses the `each.key` attribute to create a unique name for each bucket.      
+
+<CodeBlockConfig filename="my_buckets.tf">
+
+```hcl
+module "bucket" {
+  for_each = toset(["assets", "media"])
+  source   = "./publish_bucket"
+  name     = "${each.key}_bucket"
+}
+```
+
+</CodeBlockConfig>
+
+<CodeBlockConfig filename="publish_bucket/bucket-and-cloudfront.tf">
+
+```hcl
+variable "name" {} 
+
+resource "aws_s3_bucket" "example" {
+   bucket = var.name
+   #...
+}
+
+resource "aws_iam_user" "deploy_user" {
+   #...
+}
+```
+ 
+</CodeBlockConfig> 
+
+</Tab>
+
+</Tabs>
+
+### Specify a dependency
+
+The examples in this section illustrate how to specify resource dependencies.
+
+The following `resource` block partially defines an `aws_iam_role` resource. Refer to the [AWS provider documentation](https://registry.terraform.io/providers/hashicorp/aws/latest/docs/resources/iam_role) for all configuration settings. The `aws_iam_instance_profile` resource references the `aws_iam_role` resource, instructing Terraform to create the upstream resource first. 
+
+```hcl
+resource "aws_iam_role" "example" {
+  name = "example"
+  assume_role_policy = "..."
+}
+
+resource "aws_iam_instance_profile" "example" {
+  role = aws_iam_role.example.name
+}
+```
+
+The following `resource` block configures an IAM policy that lets the EC2 instance access the S3 API.
+
+```hcl
+resource "aws_iam_role_policy" "example" {
+  name   = "example"
+  role   = aws_iam_role.example.name
+  policy = jsonencode({
+    "Statement" = [{     
+      "Action" = "s3:*",
+      "Effect" = "Allow",
+    }],
+  })
+}
+```
+
+Terraform infers that it must create the instance profile before the EC2 instance, but it cannot infer that the software running in the EC2 instance needs access to the S3 API in order to boot properly. As a result, the configuration explicitly instructs Terraform to create the `aws_iam_role_policy` first:
+
+```hcl
+resource "aws_instance" "example" {
+  ami           = "data.aws_ami.example.id"
+  instance_type = "t2.micro"
+  iam_instance_profile = aws_iam_instance_profile.example
+  depends_on = [
+    aws_iam_role_policy.example
+  ]
+}
+
+data "aws_ami" "example" { 
+  # AMI configuration
+}
+```
+
+### Select an alternate provider configuration
+
+In the following example, the `google_compute_instance` resource selects the provider configuration with the `europe` alias. 
+
+```hcl
+provider "google" {
+  region = "us-central1"
+}
+
+provider "google" {
+  alias  = "europe"
+  region = "europe-west1"
+}
+
+resource "google_compute_instance" "example" {  
+  provider = google.europe
+  # ...
+}
+```
+
+### Ignore attribute changes
+
+In the following example, Terraform ignores changes to the resource's tags:
+
+```hcl
+resource "aws_instance" "example" {
+   # ...
+
+   lifecycle {
+      ignore_changes = [tags]
+   }
+}
+```
+
+### Specify triggers that replace resources
+
+In the following example, Terraform replaces `aws_appautoscaling_target` each time this instance of `aws_ecs_service` is replaced:
+
+```hcl
+resource "aws_appautoscaling_target" "ecs_target" {
+   ...
+   lifecycle {
+   replace_triggered_by = [ 
+      aws_ecs_service.svc.id
+     ]
+   }
+}
+```
+
+### Apply custom conditions
+
+The following example includes several configurations that illustrate how to define `precondition` and `postcondition` arguments in the `lifecycle` meta-argument. 
+
+The following `data` block instructs Terraform to retrieve the ID of the `ami-abc123` AMI:
+
+```hcl
+data "aws_ami" "example" {
+  owners = ["amazon"]
+  filter {
+    name   = "image-id"
+    values = ["ami-abc123"]
+  }
+}
+```
+
+In the following code, the `precondition` block specifies that the AMI ID retrieved from the `data` block must include `x86_64` as its `architecture` attribute. The `postcondition` block specifies that the EC2 instance must be allocated a public DNS hostname. When either condition is not met, Terraform returns the `error_message` for the failed condition:
+
+```hcl
+resource "aws_instance" "example" {
+  instance_type = "t3.micro"
+  ami           = data.aws_ami.example.id
+
+  lifecycle {
+    precondition {
+      condition     = data.aws_ami.example.architecture == "x86_64"
+      error_message = "The selected AMI must be for the x86_64 architecture."
+    }
+
+    postcondition {
+      condition     = self.public_dns != ""
+      error_message = "EC2 instance must be in a VPC that has public DNS hostnames enabled."
+    }
+  }
+}
+```
+
+The following `data` block retrieves the root storage volume connected to the `aws_instance.example` EC2 instance using the `volume_id` attribute. When a `data` resource verifies the result of a managed resource declared in the same configuration, you must define the check in a `postcondition` block in the resource so that Terraform waits for changes to the managed resource to complete before reading the data resource.
+
+```hcl
+data "aws_ebs_volume" "example" {
+  filter {
+    name = "volume-id"
+    values = [aws_instance.example.root_block_device[0].volume_id]
+  }
+  lifecycle {
+    # The EC2 instance will have an encrypted root volume.
+    postcondition {
+      condition     = self.encrypted
+      error_message = "The server's root volume is not encrypted."
+    }
+  }
+}
+output "api_base_url" {
+  value = "https://${aws_instance.example.private_dns}:8433/"
+}
+```
+
+### Copy content to new resources
+
+The following examples use the `file` provisioner type to copy artifacts from the machine where Terraform is running to the newly created resource.
+
+```hcl
+resource "aws_instance" "web" {
+  # ...
+
+  # Copies the myapp.conf file to /etc/myapp.conf
+  provisioner "file" {
+    source      = "conf/myapp.conf"
+    destination = "/etc/myapp.conf"
+  }
+
+  # Copies the string in content into /tmp/file.log
+  provisioner "file" {
+    content     = "ami used: ${self.ami}"
+    destination = "/tmp/file.log"
+  }
+
+  # Copies the configs.d folder to /etc/configs.d
+  provisioner "file" {
+    source      = "conf/configs.d"
+    destination = "/etc"
+  }
+
+  # Copies all files and folders in apps/app1 to D:/IIS/webapp1
+  provisioner "file" {
+    source      = "apps/app1/"
+    destination = "D:/IIS/webapp1"
+  }
+}
+```
+
+### Invoke executables
+
+You can configure provisioners to perform remote operations, such as executing scripts or running commands.
+
+In the following example, Terraform connects to the `web` instance using the `connection` settings so that the `remote-exec` provisioner can run the `puppet apply` and `consul join` commands on the resource: 
+
+```hcl
+resource "aws_instance" "web" {
+  # ...
+
+  connection {
+    type     = "ssh"
+    user     = "root"
+    password = var.root_password
+    host     = self.public_ip
+  }
+
+  provisioner "remote-exec" {
+    inline = [
+      "puppet apply",
+      "consul join ${aws_instance.web.private_ip}",
+    ]
+  }
+}
+```
+
+In the following example, Terraform uploads a script to the instance and provides inline commands to run the script:
+
+```hcl
+resource "aws_instance" "web" {
+  # ...
+
+  provisioner "file" {
+    source      = "script.sh"
+    destination = "/tmp/script.sh"
+  }
+
+  provisioner "remote-exec" {
+    inline = [
+      "chmod +x /tmp/script.sh",
+      "/tmp/script.sh args",
+    ]
+  }
+}
+```
+
+### Connect to remote resources
+
+The following example establishes a connection that all provisioners in the `resource` block can use to run commands on the remote resource:
+
+```hcl
+resource "aws_instance" "web" {
+  # ...
+
+
+  connection {
+    type     = "ssh"
+    user     = "root"
+    password = var.root_password
+    host     = self.public_ip
+  }
+
+  provisioner "remote-exec" {
+    inline = [
+      "puppet apply",
+      "consul join ${aws_instance.web.private_ip}",
+    ]
+  }
+}
+```
+
+### Define provisioner failure behaviors
+
+In the following example, Terraform runs the `echo` command on the local machine after creating the `web` resource. Terraform continues with the operation if the command fails:
+
+```hcl
+resource "aws_instance" "web" {
+  # ...
+
+  provisioner "local-exec" {
+    command    = "echo The server's IP address is ${self.private_ip}"
+    on_failure = continue
+  }
+}
+```

From ba4191fdea3b8d54a34c3cef1d18fb66442dbb53 Mon Sep 17 00:00:00 2001
From: Rose M Koron <32436232+rkoron007@users.noreply.github.com>
Date: Tue, 29 Apr 2025 14:09:50 -0700
Subject: [PATCH 07/12] Add the output reference page and align with the other
 block titles  (#36934)

---
 website/data/language-nav-data.json           |   8 +-
 website/docs/cli/inspect/index.mdx            |   4 +-
 website/docs/language/block/check.mdx         |   4 +-
 website/docs/language/block/moved.mdx         |   6 +-
 website/docs/language/block/output.mdx        | 295 ++++++++++++++++++
 website/docs/language/block/terraform.mdx     |   2 +-
 .../language/expressions/function-calls.mdx   |   2 +-
 .../docs/language/expressions/references.mdx  |   4 +-
 .../language/functions/ephemeralasnull.mdx    |  14 +-
 .../language/functions/terraform-applying.mdx |  16 +-
 .../docs/language/meta-arguments/for_each.mdx |   2 +-
 .../docs/language/modules/develop/index.mdx   |   2 +-
 .../language/modules/develop/structure.mdx    |   2 +-
 website/docs/language/modules/syntax.mdx      |   2 +-
 .../resources/ephemeral/reference.mdx         |   8 +-
 .../resources/provisioners/connection.mdx     |   2 +-
 .../resources/provisioners/syntax.mdx         |   6 +-
 .../language/stacks/reference/tfstack.mdx     |  20 +-
 .../docs/language/state/remote-state-data.mdx |   4 +-
 website/docs/language/state/remote.mdx        |   2 +-
 .../docs/language/state/sensitive-data.mdx    |   2 +-
 .../language/test-and-validate/validate.mdx   |   2 +-
 .../language/v1-compatibility-promises.mdx    |   2 +-
 website/docs/language/values/index.mdx        |   2 +-
 website/docs/language/values/locals.mdx       |   2 +-
 website/docs/language/values/outputs.mdx      | 243 ---------------
 website/docs/language/values/variables.mdx    |   6 +-
 27 files changed, 360 insertions(+), 304 deletions(-)
 create mode 100644 website/docs/language/block/output.mdx
 delete mode 100644 website/docs/language/values/outputs.mdx

diff --git a/website/data/language-nav-data.json b/website/data/language-nav-data.json
index 7a8885c2c398..26b4ca2d24c2 100644
--- a/website/data/language-nav-data.json
+++ b/website/data/language-nav-data.json
@@ -211,7 +211,7 @@
     "routes": [
       { "title": "Overview", "path": "values" },
       { "title": "Input Variables", "path": "values/variables" },
-      { "title": "Output Values", "path": "values/outputs" },
+      { "title": "Output block", "href": "/terraform/language/block/output" },
       { "title": "Local Values", "path": "values/locals" }
     ]
   },
@@ -1116,13 +1116,17 @@
     "title": "Configuration blocks",
     "routes": [
       {
-      "title": "check",
+      "title": "Check block",
       "path": "block/check"
       },
       {
       "title": "Moved block",
       "path": "block/moved"
       },
+      {
+      "title": "Output block",
+      "path": "block/output"
+      },
       {
         "title": "Terraform block",
         "path": "block/terraform"
diff --git a/website/docs/cli/inspect/index.mdx b/website/docs/cli/inspect/index.mdx
index cd323c1724b1..63c1d2f73d86 100644
--- a/website/docs/cli/inspect/index.mdx
+++ b/website/docs/cli/inspect/index.mdx
@@ -1,5 +1,5 @@
 ---
-page_title: Inspect infrastructure 
+page_title: Inspect infrastructure
 description: >-
   The terraform inspect commands return dependency information and outputs. Learn how to use terraform inspect commands
   to understand your infrastructure.
@@ -20,7 +20,7 @@ or just to gain a deeper or more holistic understanding of your infrastructure.
 - [The `terraform graph` command](/terraform/cli/commands/graph) creates a visual
   representation of a configuration or a set of planned changes.
 - [The `terraform output` command](/terraform/cli/commands/output) can get the
-  values for the top-level [output values](/terraform/language/values/outputs) of
+  values for the top-level [output values](/terraform/language/block/output) of
   a configuration, which are often helpful when making use of the infrastructure
   Terraform has provisioned.
 - [The `terraform show` command](/terraform/cli/commands/show) can generate
diff --git a/website/docs/language/block/check.mdx b/website/docs/language/block/check.mdx
index 8dfa26b5499b..235af6acb627 100644
--- a/website/docs/language/block/check.mdx
+++ b/website/docs/language/block/check.mdx
@@ -1,9 +1,9 @@
 ---
-page_title: Check block reference
+page_title: Check block reference for the Terraform configuration language
 description: How to use the `check` block to validate infrastructure outside of the usual resource lifecycle.
 ---
 
-# `check` block
+# `check` block reference
 
 Use the `check` block to validate your infrastructure outside of the typical resource lifecycle.
 
diff --git a/website/docs/language/block/moved.mdx b/website/docs/language/block/moved.mdx
index b5dbc79ab56c..20ab9e103b23 100644
--- a/website/docs/language/block/moved.mdx
+++ b/website/docs/language/block/moved.mdx
@@ -1,5 +1,5 @@
 ---
-page_title: moved block configuration reference
+page_title: moved block reference for the Terraform configuration language
 description: Learn about the `moved` block that you can specify in Terraform configurations. The `moved` block programmatically changes the location of a resource.
 ---
 
@@ -28,7 +28,7 @@ moved {
 
 ## Specification
 
-A `moved` block supports the following configuration. 
+A `moved` block supports the following configuration.
 
 ### `moved`
 
@@ -50,4 +50,4 @@ moved {
   from = aws_instance.a
   to   = aws_instance.b
 }
-```
\ No newline at end of file
+```
diff --git a/website/docs/language/block/output.mdx b/website/docs/language/block/output.mdx
new file mode 100644
index 000000000000..0f6c0fbb49af
--- /dev/null
+++ b/website/docs/language/block/output.mdx
@@ -0,0 +1,295 @@
+---
+page_title: Output block reference for the Terraform configuration language
+description: Use the `output` block to expose information about your module's infrastructure.
+---
+
+# `output` block reference
+
+The `output` block lets you expose information about your infrastructure.
+
+> **Hands-on:** Try the [Output Data From Terraform](/terraform/tutorials/configuration-language/outputs) tutorial.
+
+## Background
+
+The value of an `output` block is similar to a return value in other programming languages. The `output` block exposes information about your infrastructure that you can reference on the command line, in HCP Terraform, and in other Terraform configurations that can access your configuration's state. The `output` block serves four main purposes in Terraform:
+
+- Child modules can expose resource attributes to parent modules.
+- Root modules can display values in CLI output.
+- Other Terraform configurations using [remote state](/terraform/language/state/remote) can access root module outputs with the `terraform_remote_state` data source.
+- Passing information from a Terraform operation to an automation tool.
+
+In HCP Terraform, your `output` block values appear in the UI after Terraform applies your configuration. You can [mark outputs as sensitive in HCP Terraform](/terraform/cloud-docs/workspaces/variables/managing-variables#sensitive-values) to hide their values in the UI and in API responses.
+
+## Configuration model
+
+The `output` block supports the following arguments:
+
+- [`output "<LABEL>"`](#output) &nbsp; block
+  - [`value`](#value) &nbsp; expression
+  - [`description`](#description) &nbsp; string
+  - [`sensitive`](#sensitive) &nbsp; boolean
+  - [`ephemeral`](#ephemeral) &nbsp; boolean
+  - [`depends_on`](#depends_on) &nbsp; list of references
+  - [`precondition`](#precondition) &nbsp; block
+    - [`condition`](#precondition) &nbsp; expression
+    - [`error_message`](#precondition) &nbsp; string
+
+## Complete configuration
+
+All available arguments are defined in the following `output` block. There are no mutually exclusive arguments for an `output` block.
+
+```hcl
+output "<LABEL>" {
+  value       = <EXPRESSION>
+  description = "<STRING>"
+  sensitive   = <true|false>
+  ephemeral   = <true|false>
+  depends_on  = [<REFERENCE>]
+
+  precondition {
+    condition     = <EXPRESSION>
+    error_message = "<STRING>"
+  }
+}
+```
+
+## Specification
+
+An `output` block supports the following configuration.
+
+### `output "<LABEL>"`
+
+[Follow Terraform's resource naming rules](/terraform/language/style#resource-naming) when declaring an `output` block.
+
+The following arguments are supported in an `output` block:
+
+| Argument | Description | Type | Required? |
+| --- | --- | --- | --- |
+| `value` | The value Terraform returns for this output. | Expression | Required |
+| `description` | A description of the output's purpose and how to use it. | String | Optional |
+| `sensitive` | Specifies if Terraform hides this value in CLI output. | Boolean | Optional |
+| `ephemeral` | Specifies whether to prevent storing this value in state. | Boolean | Optional |
+| `depends_on` | A list of explicit dependencies for this output. | List | Optional |
+| `precondition` | A condition to validate before computing the output or storing it in state. | Block | Optional |
+
+### `value`
+
+You must include a `value` argument in each `output` block. Terraform evaluates the `value` argument's expression and exposes the result as the return value of an output and stores that value in state.
+
+```hcl
+output "unique_name" {
+  value = <expression-to-evaluate>
+}
+```
+
+Any valid expression can be an output `value.` Refer to [Expressions](/terraform/language/expressions/) to learn more.
+
+#### Summary
+
+- Data type: Expression
+- Default: None
+- Required: Yes
+
+### `description`
+
+Use the `description` argument in an `output` block to explain the purpose of this output, requirements, and what kind of value this output exports.
+
+```hcl
+output "instance_ip_addr" {
+  value       = <expression-to-evaluate>
+  description = "<concise description from the perspective of a module consumer>."
+}
+```
+We recommend writing the description from the point of view of a module consumer to help consumers understand why the output exists and how to use it.
+
+#### Summary
+
+- Data type: String
+- Default: None
+
+### `sensitive`
+
+Add the `sensitive` argument to an `output` block to hide that block's value in the CLI output of a Terraform operation.
+
+```hcl
+output "admin_password" {
+  value     = <expression-to-evaluate>
+  sensitive = <boolean>
+}
+```
+
+If you set the `sensitive` argument to `true`, Terraform redacts that output value in plan and apply operations:
+
+```shell-session
+Apply complete! Resources: 1 added, 0 changed, 0 destroyed.
+
+Outputs:
+
+admin_password = (sensitive value)
+```
+
+If you use the [`terraform output` command](/terraform/cli/commands/output) with the `-json` or `-raw` command-line flags, Terraform displays `sensitive` values in plain text.
+
+Terraform also records sensitive values in state, so anyone who can access your state data can access your sensitive values. For more information about safely storing sensitive data, refer to [Sensitive data in state](/terraform/language/state/sensitive-data).
+
+#### Summary
+
+- Data type: Boolean
+- Default: `false`
+
+### `ephemeral`
+
+-> **Note**: Ephemeral outputs are available in Terraform v1.10 and later.
+
+Add the `ephemeral` argument to `output` blocks in child modules to pass data between modules without persisting that data to state or plan files. You cannot add the `ephemeral` argument to `output` blocks in the root module.
+
+```hcl
+output "unique_password" {
+  value     = <expression-to-evaluate>
+  ephemeral = <boolean>
+}
+```
+
+Passing output values between child modules and the root module is useful for managing credentials, tokens, and other temporary values that you do not want to store in state. If you enable the `ephemeral` argument on an `output` block, then your configuration must meet the following conditions:
+
+- The value of the `output` block must come from an ephemeral context.
+- You can only reference that output in other ephemeral contexts.
+
+The following ephemeral contexts can set values for output blocks with the `ephemeral` argument, and they can also reference output blocks with the `ephemeral` argument:
+- Another child module's ephemeral `output` block
+- A [write-only argument](/terraform/language/resources/ephemeral/write-only)
+- [Variables with the `ephemeral` argument](/terraform/language/values/variables#exclude-values-from-state)
+- [An `ephemeral` resource block](/terraform/language/resources/ephemeral)
+- Configuring providers in the [`provider` block](/terraform/language/providers)
+- In [provisioner](/terraform/language/resources/provisioners/syntax) and [connection](/terraform/language/resources/provisioners/connection) blocks
+
+#### Summary
+
+- Data type: Boolean
+- Default: `false`
+
+### `depends_on`
+
+The `depends_on` argument specifies an explicit dependency on another upstream resource for an `output` block. Terraform will complete all operations on the upstream resource before it computes the value of an `output` block that depends on it.
+
+```hcl
+output "unique_name" {
+  value      = <expression-to-evaluate>
+  depends_on = [<another_resource.name>]
+}
+```
+
+If the `value` expression in an `output` block references another resource, Terraform automatically determines the dependency order. If you need to establish a dependency between resources and outputs that are configured independently and do not reference each other, you can use the`depends_on` argument to declare an explicit dependency. If you add the `depends_on` argument, we recommend adding a comment to explain it.
+
+The `depends_on` block is a meta-argument. Meta-arguments are built-in arguments that control how Terraform creates resources. Refer to [Meta-arguments](/terraform/language/meta-arguments/depends_on) for additional information.
+
+<>{/* TODO: Update meta-arguments concept link once we have the page*/}</>
+
+#### Summary
+
+- Data type: List of references
+- Default: None
+
+### `precondition`
+
+The `precondition` block lets you validate that the value of an `output` block meets specific requirements. Use preconditions on outputs to validate that your output values meet your requirements before Terraform exposes them or stores their values in state.
+
+```hcl
+output "unique_name" {
+  value  = <expression-to-evaluate>
+
+  precondition {
+    condition     = <expression-to-verify>
+    error_message = "<error message string>"
+  }
+}
+```
+
+You can specify the following arguments in the `precondition` block:
+
+| Attribute | Description | Data type | Required? |
+| :---- | :---- | :---- | :---- |
+| `condition` | Expression that must return `true` for Terraform to proceed with an operation. | A valid [Conditional expression](/terraform/language/expressions/conditionals). | Required |
+| `error_message` | Message to display if the condition evaluates to `false`. | String | Required |
+
+Terraform evaluates preconditions on outputs when creating or applying a plan, and if a precondition block's `condition` expression evaluates to `false`, then Terraform throws an error with the `error_message` and stops the current operation.
+
+Refer to [Validate your configuration](/terraform/language/test-and-validate/validate#preconditions) for more details about preconditions.
+
+#### Summary
+
+- Data type: Block
+- Default: None
+
+## Examples
+
+The following examples demonstrate common use cases for `output` values.
+
+### Basic example
+
+In the following example, an `output` block exposes a server's private IP address from the current module:
+
+```hcl
+output "instance_ip_addr" {
+  value       = aws_instance.server.private_ip
+  description = "The private IP address of the main server instance."
+}
+```
+
+### Accessing child module outputs
+
+In the following example, the current module uses an output named `instance_ip_addr` from a child module named `web_server`:
+
+```hcl
+output "website_url" {
+  value = "https://${module.web_server.instance_ip_addr}"
+  description = "The URL of the web server, starting with https://."
+}
+```
+
+### Sensitive output
+
+In the following example, the `db_password` output sets the `sensitive` argument to `true` to prevent Terraform from displaying the database password in CLI output:
+
+```hcl
+output "db_password" {
+  value     = aws_db_instance.db.password
+  description = "The database password."
+  sensitive = true
+}
+```
+
+### Output with validation
+
+In the following example, the `instance_public_ip` output has a `precondition` to ensure certain conditions are met before exposing the output or saving it to state. Before `instance_public_ip` shares the public IP for server, the output's precondition ensures a server's security group has at least one ingress rule to allow traffic on ports `80` or `443`:
+
+```hcl
+output "instance_public_ip" {
+  value = aws_instance.web.public_ip
+  description = "Public IP address of the instance."
+
+  precondition {
+    condition     = length([for rule in aws_security_group.web.ingress : rule if rule.to_port == 80 || rule.to_port == 443]) > 0
+    error_message = "Security group must allow HTTP (port 80) or HTTPS (port 443) ingress traffic."
+  }
+}
+```
+If the server's security group does not allow ingress on ports `80` or `443`, then Terraform throws an error with the `error_message` and stops the current operation.
+
+### Explicit dependencies
+
+In the following example, `instance_ip_addr` adds an explicit dependency on the security group rule to ensure that Terraform creates the security group before exposing the IP address:
+
+```hcl
+output "instance_ip_addr" {
+  value       = aws_instance.server.private_ip
+  description = "The private IP address of the main server instance."
+
+  depends_on = [
+    # Services are unreachable unless the security group rule is created
+    # before exposing this IP address.
+    aws_security_group_rule.local_access,
+  ]
+}
+```
+The `output` block typically does not require explicit dependencies so we recommend that when you add an explicit dependency, include a comment to explain why it's necessary.
diff --git a/website/docs/language/block/terraform.mdx b/website/docs/language/block/terraform.mdx
index 70e0e87ccc12..f0097fd53f71 100644
--- a/website/docs/language/block/terraform.mdx
+++ b/website/docs/language/block/terraform.mdx
@@ -1,5 +1,5 @@
 ---
-page_title: Terraform block configuration reference
+page_title: Terraform block reference for the Terraform configuration language
 description: >-
   The `terraform` block allows you to configure Terraform behavior, including the Terraform version, backend, integration with HCP Terraform, and required providers.
 ---
diff --git a/website/docs/language/expressions/function-calls.mdx b/website/docs/language/expressions/function-calls.mdx
index b12f6674138e..556db72d6cb4 100644
--- a/website/docs/language/expressions/function-calls.mdx
+++ b/website/docs/language/expressions/function-calls.mdx
@@ -53,7 +53,7 @@ The expansion symbol is three periods (`...`), not a Unicode ellipsis character
 ## Using Sensitive Data as Function Arguments
 
 When using sensitive data, such as [an input variable](/terraform/language/values/variables#suppressing-values-in-cli-output)
-or [an output defined](/terraform/language/values/outputs#sensitive-suppressing-values-in-cli-output) as sensitive
+or [an output defined](/terraform/language/block/output#sensitive) as sensitive
 as function arguments, the result of the function call will be marked as sensitive.
 
 This is a conservative behavior that is true irrespective of the function being
diff --git a/website/docs/language/expressions/references.mdx b/website/docs/language/expressions/references.mdx
index f3febc16e0aa..954efdc828bb 100644
--- a/website/docs/language/expressions/references.mdx
+++ b/website/docs/language/expressions/references.mdx
@@ -92,7 +92,7 @@ block, as long as you don't introduce circular dependencies.
 If the corresponding `module` block does not have either `count` nor `for_each`
 set then the value will be an object with one attribute for each output value
 defined in the child module. To access one of the module's
-[output values](/terraform/language/values/outputs), use `module.<MODULE NAME>.<OUTPUT NAME>`.
+[output values](/terraform/language/block/output), use `module.<MODULE NAME>.<OUTPUT NAME>`.
 
 If the corresponding `module` uses `for_each` then the value will be a map
 of objects whose keys correspond with the keys in the `for_each` expression,
@@ -303,7 +303,7 @@ However, there are some limitations to that behavior as described in
 [Cases where Terraform may disclose a sensitive variable](/terraform/language/values/variables#cases-where-terraform-may-disclose-a-sensitive-variable).
 
 If you use a sensitive value from a resource attribute as part of an
-[output value](/terraform/language/values/outputs) then Terraform will require
+[output value](/terraform/language/block/output) then Terraform will require
 you to also mark the output value itself as sensitive, to confirm that you
 intended to export it.
 
diff --git a/website/docs/language/functions/ephemeralasnull.mdx b/website/docs/language/functions/ephemeralasnull.mdx
index 7e2092e63ed4..4c937983691a 100644
--- a/website/docs/language/functions/ephemeralasnull.mdx
+++ b/website/docs/language/functions/ephemeralasnull.mdx
@@ -1,14 +1,14 @@
 ---
-page_title: ephemeralasnull function reference - Functions - Configuration Language  
-description: |-  
-  The `ephemeralasnull` function accepts an ephemeral value and returns null.  
+page_title: ephemeralasnull function reference - Functions - Configuration Language
+description: |-
+  The `ephemeralasnull` function accepts an ephemeral value and returns null.
 ---
 
 # `ephemeralasnull` function reference
 
 -> **Note**: The `ephemeralasnull` function is available in Terraform v1.10 and later.
 
-This topic provides reference information about the `ephemeralasnull` function. The `ephemeralasnull` function accepts an ephemeral value and returns `null`. 
+This topic provides reference information about the `ephemeralasnull` function. The `ephemeralasnull` function accepts an ephemeral value and returns `null`.
 
 ## Introduction
 
@@ -37,7 +37,7 @@ output "example_output" {
 }
 ```
 
-For more information on which Terraform blocks can be ephemeral, refer to ephemeral [inputs](/terraform/language/values/variables#exclude-values-from-state), [outputs](/terraform/language/values/outputs#ephemeral-avoid-storing-values-in-state-or-plan-files), and [resources](/terraform/language/resources/ephemeral).
+For more information on which Terraform blocks can be ephemeral, refer to ephemeral [inputs](/terraform/language/values/variables#exclude-values-from-state), [outputs](/terraform/language/block/output#ephemeral), and [resources](/terraform/language/resources/ephemeral).
 
 ## Example use case
 
@@ -57,7 +57,7 @@ variable "configuration" {
   }
 }
 
-# This is a contrived example, but this pattern works with any object that is a mix of ephemeral and non-ephemeral values. 
+# This is a contrived example, but this pattern works with any object that is a mix of ephemeral and non-ephemeral values.
 locals {
   configuration_with_token = merge(
     var.configuration,
@@ -82,4 +82,4 @@ configuration_settings = {
   "env" = "development"
   "session_token" = tostring(null)
 }
-```
\ No newline at end of file
+```
diff --git a/website/docs/language/functions/terraform-applying.mdx b/website/docs/language/functions/terraform-applying.mdx
index 078bfc8c2f04..64d670a9c78a 100644
--- a/website/docs/language/functions/terraform-applying.mdx
+++ b/website/docs/language/functions/terraform-applying.mdx
@@ -1,7 +1,7 @@
 ---
-page_title: terraform.applying reference - Functions - Configuration Language  
-description: |-  
-  The terraform.applying symbol enables you to determine if Terraform is currently running an apply operation.  
+page_title: terraform.applying reference - Functions - Configuration Language
+description: |-
+  The terraform.applying symbol enables you to determine if Terraform is currently running an apply operation.
 ---
 
 # The `terraform.applying` symbol
@@ -19,7 +19,7 @@ locals {
   aws_read_role_arn  = "arn:aws:iam::XXXXX:role/terraform-read"
   aws_write_role_arn = "arn:aws:iam::XXXXX:role/terraform-full"
 
-  # We only need read-only credentials to plan, so if Terraform is applying 
+  # We only need read-only credentials to plan, so if Terraform is applying
   # we want to use our AWS role that allows us to write.
   role_arn = terraform.applying ? local.aws_write_role_arn : local.aws_read_role_arn
 }
@@ -28,7 +28,7 @@ locals {
 The `terraform.applying` symbol is an ephemeral value, meaning it is only available during Terraform operations and Terraform does not write this value to plan or state files. Additionally, you can only reference `terraform.applying` in ephemeral contexts:
 
 * In a [write-only argument](/terraform/language/resources/ephemeral/write-only)
-* In [ephemeral variables](/terraform/language/values/variables#exclude-values-from-state)  
-* In [local values](/terraform/language/values/locals#ephemeral-values)  
-* In [ephemeral resources](/terraform/language/resources/ephemeral)  
-* In [ephemeral outputs](/terraform/language/values/outputs#ephemeral-avoid-storing-values-in-state-or-plan-files)
\ No newline at end of file
+* In [ephemeral variables](/terraform/language/values/variables#exclude-values-from-state)
+* In [local values](/terraform/language/values/locals#ephemeral-values)
+* In [ephemeral resources](/terraform/language/resources/ephemeral)
+* In [ephemeral outputs](/terraform/language/block/output#ephemeral)
diff --git a/website/docs/language/meta-arguments/for_each.mdx b/website/docs/language/meta-arguments/for_each.mdx
index 7001fd08fdd4..a7db1fcfd1a6 100644
--- a/website/docs/language/meta-arguments/for_each.mdx
+++ b/website/docs/language/meta-arguments/for_each.mdx
@@ -110,7 +110,7 @@ including `uuid`, `bcrypt`, or `timestamp`, as their evaluation is deferred duri
 main evaluation step.
 
 Sensitive values, such as [sensitive input variables](/terraform/language/values/variables#suppressing-values-in-cli-output),
-[sensitive outputs](/terraform/language/values/outputs#sensitive-suppressing-values-in-cli-output),
+[sensitive outputs](/terraform/language/block/output#sensitive),
 or [sensitive resource attributes](/terraform/language/expressions/references#sensitive-resource-attributes),
 cannot be used as arguments to `for_each`. The value used in `for_each` is used
 to identify the resource instance and will always be disclosed in UI output,
diff --git a/website/docs/language/modules/develop/index.mdx b/website/docs/language/modules/develop/index.mdx
index aee54ee9e5ac..5081eb6d8570 100644
--- a/website/docs/language/modules/develop/index.mdx
+++ b/website/docs/language/modules/develop/index.mdx
@@ -32,7 +32,7 @@ Most commonly, modules use:
 
 * [Input variables](/terraform/language/values/variables) to accept values from
   the calling module.
-* [Output values](/terraform/language/values/outputs) to return results to the
+* [Output values](/terraform/language/block/output) to return results to the
   calling module, which it can then use to populate arguments elsewhere.
 * [Resources](/terraform/language/resources) to define one or more
   infrastructure objects that the module will manage.
diff --git a/website/docs/language/modules/develop/structure.mdx b/website/docs/language/modules/develop/structure.mdx
index 20ba5c945881..df07d7cd1e07 100644
--- a/website/docs/language/modules/develop/structure.mdx
+++ b/website/docs/language/modules/develop/structure.mdx
@@ -56,7 +56,7 @@ don't need to do any extra work to follow the standard structure.
   outputs should have one or two sentence descriptions that explain their
   purpose. This is used for documentation. See the documentation for
   [variable configuration](/terraform/language/values/variables) and
-  [output configuration](/terraform/language/values/outputs) for more details.
+  [output configuration](/terraform/language/block/output) for more details.
 
 * **Nested modules**. Nested modules should exist under the `modules/`
   subdirectory. Any nested module with a `README.md` is considered usable
diff --git a/website/docs/language/modules/syntax.mdx b/website/docs/language/modules/syntax.mdx
index e23e26ada9bf..ca4facc2bbd8 100644
--- a/website/docs/language/modules/syntax.mdx
+++ b/website/docs/language/modules/syntax.mdx
@@ -140,7 +140,7 @@ Terraform does not use the `lifecycle` argument. However, the `lifecycle` block
 
 The resources defined in a module are encapsulated, so the calling module
 cannot access their attributes directly. However, the child module can
-declare [output values](/terraform/language/values/outputs) to selectively
+declare [output values](/terraform/language/block/output) to selectively
 export certain values to be accessed by the calling module.
 
 For example, if the `./app-cluster` module referenced in the example above
diff --git a/website/docs/language/resources/ephemeral/reference.mdx b/website/docs/language/resources/ephemeral/reference.mdx
index 8c2324c854cb..7842e12ad611 100644
--- a/website/docs/language/resources/ephemeral/reference.mdx
+++ b/website/docs/language/resources/ephemeral/reference.mdx
@@ -5,7 +5,7 @@ description: Learn to define ephemeral blocks in Terraform configurations to kee
 
 # Ephemeral block configuration reference
 
-This topic provides reference information for the `ephemeral` block. 
+This topic provides reference information for the `ephemeral` block.
 
 -> **Note**: Ephemeral resources are available in Terraform v1.10 and later.
 
@@ -26,9 +26,9 @@ If an input argument of an ephemeral resource references a value that Terraform
 An `ephemeral` block declares an ephemeral resource of a specific type with a
 specific local name, much like a `resource` block. Terraform uses an ephemeral resource's name to refer to that resource in the same module, but an ephemeral resource's name has no meaning outside that module's scope.
 
-Most of the arguments within the body of an `ephemeral` block are specific to the ephemeral resource you are defining. As with resources and data sources, each provider in the [Terraform Registry](https://registry.terraform.io/browse/providers) includes documentation for the ephemeral resources it supports, if any. An ephemeral resource type's documentation lists which arguments are available and how you should format your resource's values. 
+Most of the arguments within the body of an `ephemeral` block are specific to the ephemeral resource you are defining. As with resources and data sources, each provider in the [Terraform Registry](https://registry.terraform.io/browse/providers) includes documentation for the ephemeral resources it supports, if any. An ephemeral resource type's documentation lists which arguments are available and how you should format your resource's values.
 
-The following list outlines general field hierarchy, language-specific data types, and requirements in the `ephemeral` block. 
+The following list outlines general field hierarchy, language-specific data types, and requirements in the `ephemeral` block.
 
 - [`ephemeral`](#ephemeral): map
   - [`attributes`](#ephemeral)
@@ -55,7 +55,7 @@ ephemeral resources:
 * In another ephemeral resource
 * In [local values](/terraform/language/values/locals#ephemeral-values)
 * In [ephemeral variables](/terraform/language/values/variables#exclude-values-from-state)
-* In [ephemeral outputs](/terraform/language/values/outputs#ephemeral-avoid-storing-values-in-state-or-plan-files)
+* In [ephemeral outputs](/terraform/language/block/output#ephemeral)
 * Configuring providers in the `provider` block
 * In [provisioner](/terraform/language/resources/provisioners/syntax) and [connection](/terraform/language/resources/provisioners/connection) blocks
 
diff --git a/website/docs/language/resources/provisioners/connection.mdx b/website/docs/language/resources/provisioners/connection.mdx
index 333b58e4c164..8822f7188c35 100644
--- a/website/docs/language/resources/provisioners/connection.mdx
+++ b/website/docs/language/resources/provisioners/connection.mdx
@@ -43,7 +43,7 @@ The configuration for a `connection` block may use ephemeral values, such as
 local values](/terraform/language/values/locals#ephemeral-values), [`ephemeral`
 variables](/terraform/language/values/variables#ephemeral), or [`ephemeral`
 output
-values](/terraform/language/values/outputs#ephemeral-avoid-storing-values-in-state-or-plan-files).
+values](/terraform/language/block/output#ephemeral).
 
 Terraform will not store these values in your plan or state, or output them in
 logs.
diff --git a/website/docs/language/resources/provisioners/syntax.mdx b/website/docs/language/resources/provisioners/syntax.mdx
index cf73194a1098..9e06a657e2c7 100644
--- a/website/docs/language/resources/provisioners/syntax.mdx
+++ b/website/docs/language/resources/provisioners/syntax.mdx
@@ -97,7 +97,7 @@ remote access credentials to be provided.
 
 ### Provisioning files using cloud-config
 
-You can add the [`cloudinit_config`](https://registry.terraform.io/providers/hashicorp/cloudinit/latest/docs) data source to your Terraform configuration and specify the files you want to provision as `text/cloud-config` content. The `cloudinit_config` data source renders multi-part MIME configurations for use with [cloud-init](https://cloudinit.readthedocs.io/en/latest/). Pass the files in the `content` field as YAML-encoded configurations using the `write_files` block. 
+You can add the [`cloudinit_config`](https://registry.terraform.io/providers/hashicorp/cloudinit/latest/docs) data source to your Terraform configuration and specify the files you want to provision as `text/cloud-config` content. The `cloudinit_config` data source renders multi-part MIME configurations for use with [cloud-init](https://cloudinit.readthedocs.io/en/latest/). Pass the files in the `content` field as YAML-encoded configurations using the `write_files` block.
 
 In the following example, the `my_cloud_config` data source specifies a `text/cloud-config` MIME part named `cloud.conf`. The `part.content` field is set to [`yamlencode`](/terraform/language/functions/yamlencode), which encodes the `write_files` JSON object as YAML so that the system can provision the referenced files.
 
@@ -233,7 +233,7 @@ The configuration for a `provisioner` block may use ephemeral values, such as
 local values](/terraform/language/values/locals#ephemeral-values), [`ephemeral`
 variables](/terraform/language/values/variables#ephemeral), or [`ephemeral`
 output
-values](/terraform/language/values/outputs#ephemeral-avoid-storing-values-in-state-or-plan-files).
+values](/terraform/language/block/output#ephemeral).
 
 Terraform does not store these values in your plan or state, or output them in
 logs.
@@ -242,7 +242,7 @@ logs.
 
 The configuration for a `provisioner` block may use sensitive values, such as
 [`sensitive` variables](/terraform/language/values/variables#suppressing-values-in-cli-output)
-or [`sensitive` output values](/terraform/language/values/outputs#sensitive-suppressing-values-in-cli-output).
+or [`sensitive` output values](/terraform/language/block/output#sensitive).
 Terraform suppresses sensitive values in all log output.
 
 ## Creation-Time Provisioners
diff --git a/website/docs/language/stacks/reference/tfstack.mdx b/website/docs/language/stacks/reference/tfstack.mdx
index d7768341260d..4f6d1ce52684 100644
--- a/website/docs/language/stacks/reference/tfstack.mdx
+++ b/website/docs/language/stacks/reference/tfstack.mdx
@@ -5,7 +5,7 @@ description: Stacks help you provision and coordinate your infrastructure lifecy
 
 # Stack configuration file reference
 
-A Stack configuration file defines all the infrastructure pieces included in a Stack. Every Stack needs a configuration file, `tfstack.hcl`, and this page describes all the blocks you can use within a Stack configuration file. 
+A Stack configuration file defines all the infrastructure pieces included in a Stack. Every Stack needs a configuration file, `tfstack.hcl`, and this page describes all the blocks you can use within a Stack configuration file.
 
 ## `component` block configuration
 
@@ -66,7 +66,7 @@ component "s3" {
 
 To learn more about breaking down your infrastructure into components, refer to [Define Stack configuration](/terraform/language/stacks/create/config).
 
-## `variable` block configuration 
+## `variable` block configuration
 
 Use the `variable` block to declare input variables for your Stack configuration. Using `variable` blocks in Stacks is similar to traditional Terraform configurations but with a few minor differences.
 
@@ -100,9 +100,9 @@ This section provides details about the fields you can configure in the `variabl
 
 ## `output` block configuration
 
-Use the `output` block to make information about your infrastructure available in the HCP Terraform UI to expose information about your Stack. The `output` block functions the same way in Stack configuration as it does in traditional Terraform configurations with a few small differences. 
+Use the `output` block to make information about your infrastructure available in the HCP Terraform UI to expose information about your Stack. The `output` block functions the same way in Stack configuration as it does in traditional Terraform configurations with a few small differences.
 
-In Stack configurations, `output` blocks require the `type` argument, and they do not support the `preconditions` block. Learn more about [Outputs](/terraform/language/values/outputs).
+In Stack configurations, `output` blocks require the `type` argument, and they do not support the `preconditions` block. Learn more about [Outputs](/terraform/language/block/output).
 
 ### Complete configuration
 
@@ -131,14 +131,14 @@ This section provides details about the fields you can configure in the `output`
 
 ## `required_providers` and `provider` block configuration
 
-Terraform relies on plugins called providers to interact with cloud providers, SaaS providers, and other APIs. 
+Terraform relies on plugins called providers to interact with cloud providers, SaaS providers, and other APIs.
 
-The `required_providers` block works exactly as it does in traditional Terraform configurations. Learn more about [the `required_providers` block](/terraform/language/providers/requirements). The `provider` block functions mostly the same way in Stack configuration as it does in traditional Terraform configurations, with a few differences. 
+The `required_providers` block works exactly as it does in traditional Terraform configurations. Learn more about [the `required_providers` block](/terraform/language/providers/requirements). The `provider` block functions mostly the same way in Stack configuration as it does in traditional Terraform configurations, with a few differences.
 
 The `provider` block differs in Stack configurations in the following ways:
 
-* Supports the `for_each` [meta-argument](/terraform/language/meta-arguments/for_each)  
-* Defines aliases in the `provider` block header rather than as an argument  
+* Supports the `for_each` [meta-argument](/terraform/language/meta-arguments/for_each)
+* Defines aliases in the `provider` block header rather than as an argument
 * Accepts arguments using a config block
 
 You must also define your providers at the top level of your Stack configuration in a `tfstack.hcl` file. You cannot define providers within the modules your component blocks source.
@@ -199,9 +199,9 @@ A local value assigns a name to an expression, so you can use the name multiple
 
 ## `removed` block configuration
 
-Stacks take a systematic approach to removing components. To remove a component from a Stack, you must use the `removed` block to ensure HCP Terraform knows which components to remove and which providers it requires to remove that component. 
+Stacks take a systematic approach to removing components. To remove a component from a Stack, you must use the `removed` block to ensure HCP Terraform knows which components to remove and which providers it requires to remove that component.
 
-Do not remove providers from your stack configuration without first removing the components that require those providers. HCP Terraform requires a component's providers to ensure it can successfully remove that component. 
+Do not remove providers from your stack configuration without first removing the components that require those providers. HCP Terraform requires a component's providers to ensure it can successfully remove that component.
 
 
 ### Complete configuration
diff --git a/website/docs/language/state/remote-state-data.mdx b/website/docs/language/state/remote-state-data.mdx
index c3c230e6b274..dfee255a0773 100644
--- a/website/docs/language/state/remote-state-data.mdx
+++ b/website/docs/language/state/remote-state-data.mdx
@@ -167,8 +167,8 @@ The following arguments are supported:
 In addition to the above, the following attributes are exported:
 
 * (v0.12+) `outputs` - An object containing every root-level
-  [output](/terraform/language/values/outputs) in the remote state.
-* (<= v0.11) `<OUTPUT NAME>` - Each root-level [output](/terraform/language/values/outputs)
+  [output](/terraform/language/block/output) in the remote state.
+* (<= v0.11) `<OUTPUT NAME>` - Each root-level [output](/terraform/language/block/output)
   in the remote state appears as a top level attribute on the data source.
 
 ## Root Outputs Only
diff --git a/website/docs/language/state/remote.mdx b/website/docs/language/state/remote.mdx
index 73875a2c17bc..45cc5847f8e8 100644
--- a/website/docs/language/state/remote.mdx
+++ b/website/docs/language/state/remote.mdx
@@ -24,7 +24,7 @@ HCP Terraform, both of which you can configure in your configuration's root modu
 ## Delegation and Teamwork
 
 Remote state allows you to share
-[output values](/terraform/language/values/outputs) with other configurations.
+[output values](/terraform/language/block/output) with other configurations.
 This allows your infrastructure to be decomposed into smaller components.
 
 Put another way, remote state also allows teams to share infrastructure
diff --git a/website/docs/language/state/sensitive-data.mdx b/website/docs/language/state/sensitive-data.mdx
index 788654a0d61c..fd758b4215b2 100644
--- a/website/docs/language/state/sensitive-data.mdx
+++ b/website/docs/language/state/sensitive-data.mdx
@@ -19,7 +19,7 @@ When using [remote state](/terraform/language/state/remote), state is only ever
 
 Terraform allows you to mark variables and outputs as ephemeral. Providers can also support specific `ephemeral` resources. Ephemerality in Terraform means that the data of a block is available during runtime, but Terraform does not write that data to state or plan files. The `ephemeral` property is helpful when managing credentials, tokens, or other temporary resources you do not want to store in Terraform state files.
 
-Learn more about defining ephemeral [input variables](/terraform/language/values/variables#exclude-values-from-state), [outputs](/terraform/language/values/outputs#ephemeral-avoid-storing-values-in-state-or-plan-files), and [resources](/terraform/language/resources/ephemeral).
+Learn more about defining ephemeral [input variables](/terraform/language/values/variables#exclude-values-from-state), [outputs](/terraform/language/block/output#ephemeral), and [resources](/terraform/language/resources/ephemeral).
 
 ## Recommendations
 
diff --git a/website/docs/language/test-and-validate/validate.mdx b/website/docs/language/test-and-validate/validate.mdx
index 484250b366bc..1b864b7ed374 100644
--- a/website/docs/language/test-and-validate/validate.mdx
+++ b/website/docs/language/test-and-validate/validate.mdx
@@ -110,7 +110,7 @@ output "instance_public_ip" {
 }
 ```
 
-If the `precondition` fails, Terraform throws an error with the `error_message` and stops the current operation. Refer to the [`output` block reference](/terraform/language/values/outputs) for more details.
+If the `precondition` fails, Terraform throws an error with the `error_message` and stops the current operation. Refer to the [`output` block reference](/terraform/language/block/output) for more details.
 
 #### Postconditions
 
diff --git a/website/docs/language/v1-compatibility-promises.mdx b/website/docs/language/v1-compatibility-promises.mdx
index 75d560069532..d578b3f12960 100644
--- a/website/docs/language/v1-compatibility-promises.mdx
+++ b/website/docs/language/v1-compatibility-promises.mdx
@@ -79,7 +79,7 @@ providers) will retain their current functionality:
 * [`provider`](/terraform/language/providers/configuration) blocks to configure
   providers, and the `alias` meta-argument.
 * [`variable`](/terraform/language/values/variables#declaring-an-input-variable),
-  [`output`](/terraform/language/values/outputs#declaring-an-output-value), and
+  [`output`](/terraform/language/block/output), and
   [`locals`](/terraform/language/values/locals#declaring-a-local-value) blocks
   for declaring the various kinds of named values in a module.
 * [`terraform`](/terraform/language/terraform) blocks, including the nested
diff --git a/website/docs/language/values/index.mdx b/website/docs/language/values/index.mdx
index bd207554bfae..caa9354434c2 100644
--- a/website/docs/language/values/index.mdx
+++ b/website/docs/language/values/index.mdx
@@ -13,7 +13,7 @@ publishing named values.
 - [Input Variables](/terraform/language/values/variables) serve as parameters for
   a Terraform module, so users can customize behavior without editing the source.
 
-- [Output Values](/terraform/language/values/outputs) are like return values for a
+- [Output Values](/terraform/language/block/output) are like return values for a
   Terraform module.
 
 - [Local Values](/terraform/language/values/locals) are a convenience feature for
diff --git a/website/docs/language/values/locals.mdx b/website/docs/language/values/locals.mdx
index e831cba02cf3..d659d9f2c6a7 100644
--- a/website/docs/language/values/locals.mdx
+++ b/website/docs/language/values/locals.mdx
@@ -17,7 +17,7 @@ If you're familiar with traditional programming languages, it can be useful to
 compare Terraform modules to function definitions:
 
 - [Input variables](/terraform/language/values/variables) are like function arguments.
-- [Output values](/terraform/language/values/outputs) are like function return values.
+- [Output values](/terraform/language/block/output) are like function return values.
 - Local values are like a function's temporary local variables.
 
 -> **Note:** For brevity, local values are often referred to as just "locals"
diff --git a/website/docs/language/values/outputs.mdx b/website/docs/language/values/outputs.mdx
deleted file mode 100644
index 813c3aa25d97..000000000000
--- a/website/docs/language/values/outputs.mdx
+++ /dev/null
@@ -1,243 +0,0 @@
----
-page_title: Output Values - Configuration Language
-description: Output values are the return values of a Terraform module.
----
-
-# Output Values
-
-Output values make information about your infrastructure available on the
-command line, and can expose information for other Terraform configurations to
-use. Output values are similar to return values in programming languages.
-
-> **Hands-on:** Try the [Output Data From
-> Terraform](/terraform/tutorials/configuration-language/outputs)
-> tutorial.
-
-Output values have several uses:
-
-- A child module can use outputs to expose a subset of its resource attributes
-  to a parent module.
-- A root module can use outputs to print certain values in the CLI output after
-  running `terraform apply`.
-- When using [remote state](/terraform/language/state/remote), root module outputs can be
-  accessed by other configurations via a
-  [`terraform_remote_state` data source](/terraform/language/state/remote-state-data).
-
-Resource instances managed by Terraform each export attributes whose values
-can be used elsewhere in configuration. Output values are a way to expose some
-of that information to the user of your module.
-
--> **Note:** For brevity, output values are often referred to as just "outputs"
-when the meaning is clear from context.
-
-## Declaring an Output Value
-
-Each output value exported by a module must be declared using an `output`
-block:
-
-```hcl
-output "instance_ip_addr" {
-  value = aws_instance.server.private_ip
-}
-```
-
-The label immediately after the `output` keyword is the name, which must be a
-valid [identifier](/terraform/language/syntax/configuration#identifiers). In a root module, this name is
-displayed to the user; in a child module, it can be used to access the output's
-value.
-
-The `value` argument takes an [expression](/terraform/language/expressions)
-whose result is to be returned to the user. In this example, the expression
-refers to the `private_ip` attribute exposed by an `aws_instance` resource
-defined elsewhere in this module (not shown). Any valid expression is allowed
-as an output value.
-
--> **Note:** Outputs are only rendered when Terraform applies your plan. Running
-`terraform plan` will not render outputs.
-
-## Accessing Child Module Outputs
-
-In a parent module, outputs of child modules are available in expressions as
-`module.<MODULE NAME>.<OUTPUT NAME>`. For example, if a child module named
-`web_server` declared an output named `instance_ip_addr`, you could access that
-value as `module.web_server.instance_ip_addr`.
-
-
-## Preconditions
-
-You can use `precondition` blocks to specify guarantees about output data. The following examples creates a precondition that checks whether the EC2 instance has an encrypted root volume.
-
-```hcl
-output "api_base_url" {
-  value = "https://${aws_instance.example.private_dns}:8433/"
-
-  # The EC2 instance must have an encrypted root volume.
-  precondition {
-    condition     = data.aws_ebs_volume.example.encrypted
-    error_message = "The server's root volume is not encrypted."
-  }
-}
-```
-
-Validating your configuration can help capture assumptions, helping future maintainers understand the configuration design and intent. They also return useful information about errors earlier and in context, helping consumers more easily diagnose issues in their configurations.
-
-Refer to [Validate your configuration](/terraform/language/test-and-validate/validate#preconditions-and-postconditions) for more details.
-
-## Optional Arguments
-
-`output` blocks can optionally include `description`, `sensitive`, `ephemeral`, and `depends_on` arguments, which are described in the following sections.
-
-<a id="description"></a>
-
-### `description` — Output Value Documentation
-
-Because the output values of a module are part of its user interface, you can
-briefly describe the purpose of each value using the optional `description`
-argument:
-
-```hcl
-output "instance_ip_addr" {
-  value       = aws_instance.server.private_ip
-  description = "The private IP address of the main server instance."
-}
-```
-
-The description should concisely explain the
-purpose of the output and what kind of value is expected. This description
-string might be included in documentation about the module, and so it should be
-written from the perspective of the user of the module rather than its
-maintainer. For commentary for module maintainers, use comments.
-
-<a id="ephemeral"></a>
-
-### `ephemeral` — Avoid storing values in state or plan files
-
--> **Note**: Ephemeral outputs are available in Terraform v1.10 and later.
-
-You can mark `output` values as `ephemeral` in child modules to pass ephemeral values between modules while avoiding persisting those values to state or plan files. This is useful for managing credentials, tokens, or other temporary resources you do not want to store in Terraform state files.
-
-You can mark an `output` in a child module as ephemeral by setting the `ephemeral` attribute to `true`:
-
-```hcl
-# modules/db/main.tf
-
-output "secret_id" {
-  value       = aws_secretsmanager_secret.secret_id
-  description = "Temporary secret ID for accessing database in AWS."
-  ephemeral   = true
-}
-```
-
-Terraform has access to the value of `output` blocks during plan and apply operations. At the end of a plan or apply operation, Terraform does not persist the value of any ephemeral outputs.
-
-You can only reference ephemeral outputs in specific contexts or Terraform throws an error. The following are valid contexts for referencing ephemeral outputs:
-
-* In a [write-only argument](/terraform/language/resources/ephemeral/write-only)
-* In another child module's ephemeral `output` block
-* In [ephemeral variables](/terraform/language/values/variables#exclude-values-from-state)
-* In [ephemeral resources](/terraform/language/resources/ephemeral)
-
-Note that you cannot set an `output` value as `ephemeral` in the root module.
-
-
-<a id="sensitive"></a>
-
-### `sensitive` — Suppressing Values in CLI Output
-
-An output can be marked as containing sensitive material using the optional
-`sensitive` argument:
-
-```hcl
-output "db_password" {
-  value       = aws_db_instance.db.password
-  description = "The password for logging in to the database."
-  sensitive   = true
-}
-```
-
-Terraform will hide values marked as sensitive in the messages from
-`terraform plan` and `terraform apply`. In the following scenario, our root
-module has an output declared as sensitive and a module call with a
-sensitive output, which we then use in a resource attribute.
-
-```hcl
-# main.tf
-
-module "foo" {
-  source = "./mod"
-}
-
-resource "test_instance" "x" {
-  some_attribute = module.foo.a # resource attribute references a sensitive output
-}
-
-output "out" {
-  value     = "xyz"
-  sensitive = true
-}
-
-# mod/main.tf, our module containing a sensitive output
-
-output "a" {
-  value     = "secret"
-  sensitive = true
-}
-```
-
-When we run a plan or apply, the sensitive value is redacted from output:
-
-```
-Terraform will perform the following actions:
-
-  # test_instance.x will be created
-  + resource "test_instance" "x" {
-      + some_attribute    = (sensitive value)
-    }
-
-Plan: 1 to add, 0 to change, 0 to destroy.
-
-Changes to Outputs:
-  + out = (sensitive value)
-```
-
-Terraform will still record sensitive values in the [state](/terraform/language/state),
-and so anyone who can access the state data will have access to the sensitive
-values in cleartext. For more information, see
-[Sensitive Data in State](/terraform/language/state/sensitive-data).
-
-<a id="depends_on"></a>
-
-### `depends_on` — Explicit Output Dependencies
-
-Since output values are just a means for passing data out of a module, it is
-usually not necessary to worry about their relationships with other nodes in
-the dependency graph.
-
-However, when a parent module accesses an output value exported by one of its
-child modules, the dependencies of that output value allow Terraform to
-correctly determine the dependencies between resources defined in different
-modules.
-
-Just as with
-[resource dependencies](/terraform/language/resources/behavior#resource-dependencies),
-Terraform analyzes the `value` expression for an output value and automatically
-determines a set of dependencies, but in less-common cases there are
-dependencies that cannot be recognized implicitly. In these rare cases, the
-`depends_on` argument can be used to create additional explicit dependencies:
-
-```hcl
-output "instance_ip_addr" {
-  value       = aws_instance.server.private_ip
-  description = "The private IP address of the main server instance."
-
-  depends_on = [
-    # Security group rule must be created before this IP address could
-    # actually be used, otherwise the services will be unreachable.
-    aws_security_group_rule.local_access,
-  ]
-}
-```
-
-The `depends_on` argument should be used only as a last resort. When using it,
-always include a comment explaining why it is being used, to help future
-maintainers understand the purpose of the additional dependency.
diff --git a/website/docs/language/values/variables.mdx b/website/docs/language/values/variables.mdx
index 3d3ed7d4adcd..a6738f370531 100644
--- a/website/docs/language/values/variables.mdx
+++ b/website/docs/language/values/variables.mdx
@@ -22,7 +22,7 @@ If you're familiar with traditional programming languages, it can be useful to
 compare Terraform modules to function definitions:
 
 * Input variables are like function arguments.
-* [Output values](/terraform/language/values/outputs) are like function return values.
+* [Output values](/terraform/language/block/output) are like function return values.
 * [Local values](/terraform/language/values/locals) are like a function's temporary local variables.
 
 -> **Note:** For brevity, input variables are often referred to as just
@@ -202,7 +202,7 @@ You can only reference ephemeral variables in specific contexts or Terraform thr
 * Another ephemeral variable
 * In [local values](/terraform/language/values/locals#ephemeral-values)
 * In [ephemeral resources](/terraform/language/resources/ephemeral)
-* In [ephemeral outputs](/terraform/language/values/outputs#ephemeral-avoid-storing-values-in-state-or-plan-files)
+* In [ephemeral outputs](/terraform/language/block/output#ephemeral)
 * Configuring providers in the `provider` block
 * In [provisioner](/terraform/language/resources/provisioners/syntax) and [connection](/terraform/language/resources/provisioners/connection) blocks
 
@@ -293,7 +293,7 @@ you assign it a value. For more information, see
 [Sensitive Resource Attributes](/terraform/language/expressions/references#sensitive-resource-attributes).
 
 If you use a sensitive value as part of an
-[output value](/terraform/language/values/outputs) then Terraform will require
+[output value](/terraform/language/block/output) then Terraform will require
 you to also mark the output value itself as sensitive, to confirm that you
 intended to export it.
 

From 9eaf24ef1bf8b9ad5243606908799298419f4d18 Mon Sep 17 00:00:00 2001
From: trujillo-adam <47586768+trujillo-adam@users.noreply.github.com>
Date: Wed, 30 Apr 2025 15:26:28 -0700
Subject: [PATCH 08/12] Apply suggestions from code review

Co-authored-by: rita <8647768+ritsok@users.noreply.github.com>
---
 website/docs/language/block/resource.mdx | 22 ++++++++++++----------
 1 file changed, 12 insertions(+), 10 deletions(-)

diff --git a/website/docs/language/block/resource.mdx b/website/docs/language/block/resource.mdx
index 295d4a61429d..efef750cbe1a 100644
--- a/website/docs/language/block/resource.mdx
+++ b/website/docs/language/block/resource.mdx
@@ -150,7 +150,9 @@ A `resource` block supports the following configuration.
 You must set the following arguments for every `resource` block: 
 
 - `TYPE`: Specifies the type of resource. This value is determined by the provider developer. Refer to provider documentation for details. The `terraform_data` resource type, which you can use to store values and trigger Terraform operations without creating actual infrastructure, is the exception. 
-- `LABEL`: Specifies a name for the resource. Terraform uses this label to track the resource in your state file. To reference the resource in your configuration, you must refer to it using `<TYPE>.<LABEL>` syntax. The label does not affect settings on the actual infrastructure resource. Refer to [References to Named Values](/terraform/language/expressions/references) and [Resource naming](/terraform/language/style#resource-naming) for expression syntax and label recommendations.
+- `LABEL`: Specifies a name for the resource. Terraform uses this label to track the resource in your state file. The label does not affect settings on the actual infrastructure resource. Refer to [References to Named Values](/terraform/language/expressions/references) and [Resource naming](/terraform/language/style#resource-naming) for expression syntax and label recommendations.
+
+To reference the resource in your configuration, you must refer to it using `<TYPE>.<LABEL>` syntax. 
 
 ### Provider-specific arguments
 
@@ -196,9 +198,9 @@ resource {
 }
 ```
 
-When a resource configuration refers to another resource, Terraform identifies the dependency and creates the upstream resource first. In some cases, you may need Terraform to create a resource before creating another, even though the resources are configured independently. 
+When a resource configuration refers to another resource, Terraform identifies the dependency and creates the upstream resource first. In some cases, you may need Terraform to create one resource before creating another, even though the resources are configured independently. 
 
-Use the `depends_on` argument when Terraform cannot infer a dependency automatically. We recommend always including a comment to explain resource dependencies when using a `depends_on` argument.
+Use the `depends_on` argument when the resources do not reference each other. We recommend always including a comment to explain resource dependencies when using a `depends_on` argument.
 
 When using the `depends_on` meta-argument, you can only reference other resources or child modules in the same root module. The list cannot include arbitrary expressions. Any values referenced in the `depends_on` list must be known before Terraform begins the operation so that it can evaluate dependencies.
 
@@ -252,7 +254,7 @@ Keys in the `for_each` argument cannot be the result of or rely on the result of
 
 The `for_each` argument does not implicitly convert lists or tuples to sets. To declare resource instances based on a nested data structure or combinations of elements from multiple data structures, you can use Terraform expressions and functions to derive a suitable value. Refer to the following examples for additional information:
 
-- [Transform a multi-level nested structure into a flat list](/terraform/language/functions/flatten#flattening-nested-structures-for-for_each)
+- [Transform a multi-level nested structure into a flat list](/terraform/language/functions/flatten#flattening-nested-structures-for-for_each).
 - [Combine collections to produce a list of element combinations](/terraform/language/functions/setproduct#finding-combinations-for-for_each).
 
 You cannot use sensitive values, such as [sensitive input variables](/terraform/language/values/variables#suppressing-values-in-cli-output), [sensitive outputs](/terraform/language/values/outputs#sensitive-suppressing-values-in-cli-output), or [sensitive resource attributes](/terraform/language/expressions/references#sensitive-resource-attributes), as arguments in `for_each`. Terraform uses the value in `for_each` to identify the resource instance and always discloses it in UI output, so sensitive values are not allowed. Terraform returns an error if you attempt to use sensitive values as `for_each` arguments.
@@ -312,10 +314,10 @@ resource {
 
 You can specify the following lifecycle rules to manage how Terraform performs operations on the resource:
 
-- [`create_before_destroy`](#create_before_destroy): Terraform creates a replacement resource before destroying the previous resource.
+- [`create_before_destroy`](#create_before_destroy): Terraform creates a replacement resource before destroying the current resource.
 - [`prevent_destroy`](#prevent_destroy): Terraform rejects operations to destroy the resource and returns an error.
-- [`ignore_changes`](#ignore_changes):  Specifies a list of resource attributes that, when modified outside of your configuration, Terraform ignores instead of attempting to update the actual resource to match the configuration.  
-- [`replace_triggered_by`](#replace-triggered_by): Terraform replaces the resource when any of the referenced resources or attributes specified change.
+- [`ignore_changes`](#ignore_changes):  Specifies a list of resource attributes that Terraform ignores changes to. Otherwise, Terraform attempts to update the actual resource to match the configuration.  
+- [`replace_triggered_by`](#replace-triggered_by): Terraform replaces the resource when any of the referenced resources or specified attributes change.
 - [`precondition`](#precondition): Specifies a condition that Terraform evaluates before creating the resource. Refer to [Test and validate](/terraform/language/test-and-validate) for additional information.
 - [`postcondition`](#postcondition): Specifies a condition that Terraform evaluates after creating the resource. Refer to [Test and validate](/terraform/language/test-and-validate) for additional information.
 
@@ -725,7 +727,7 @@ resource {
 }
 ```
 
-Terraform evaluates the command in a local shell and can use environment variables for variable substitution. We do not recommend using Terraform variables for variable substitution because doing so can lead to shell injection vulnerabilities. Instead, you should pass Terraform variables to a command through the environment parameter and use environment variable substitution. Refer to the following OWASP article for additional information about injection flaws: [Code Injection](https://owasp.org/www-community/attacks/Code_Injection).
+Terraform evaluates the command in a local shell and can use environment variables for variable substitution. We do not recommend using Terraform variables for variable substitution because doing so can lead to shell injection vulnerabilities. Instead, use the `environment` parameter and environment variable substitution. Refer to the following OWASP article for additional information about injection flaws: [Code Injection](https://owasp.org/www-community/attacks/Code_Injection).
 
 #### Summary
 
@@ -852,7 +854,7 @@ resource "aws_instance" "web" {
 
 ### Create multiple instances of a resource
 
-You can use either `count` or the `for_each` block to create multiple instances of a resource. The `count` argument is most suitable for creating multiple instances that are identical or nearly identical. The `for_each` argument is most suitable for creating multiple similar instances that you capture and reference from a map or set.
+You can use either `count` or the `for_each` block to create multiple instances of a resource. The `count` argument is most suitable for creating multiple instances that are identical or nearly identical. The `for_each` argument is most suitable for creating multiple similar instances based on attributes defined in a map or set.
 
 <Tabs>
 
@@ -942,7 +944,7 @@ resource "aws_iam_user" "deploy_user" {
 
 ### Specify a dependency
 
-The examples in this section illustrate how to specify resource dependencies.
+The examples in this section show how to specify resource dependencies.
 
 The following `resource` block partially defines an `aws_iam_role` resource. Refer to the [AWS provider documentation](https://registry.terraform.io/providers/hashicorp/aws/latest/docs/resources/iam_role) for all configuration settings. The `aws_iam_instance_profile` resource references the `aws_iam_role` resource, instructing Terraform to create the upstream resource first. 
 

From d6adc077e8561a9d01eeac924cff94366dcda660 Mon Sep 17 00:00:00 2001
From: trujillo-adam <ajosetru@gmail.com>
Date: Wed, 30 Apr 2025 15:54:25 -0700
Subject: [PATCH 09/12] replaced 'additional information' with 'more
 information'

---
 website/docs/language/block/resource.mdx | 34 ++++++++++++------------
 1 file changed, 17 insertions(+), 17 deletions(-)

diff --git a/website/docs/language/block/resource.mdx b/website/docs/language/block/resource.mdx
index efef750cbe1a..e61223db3818 100644
--- a/website/docs/language/block/resource.mdx
+++ b/website/docs/language/block/resource.mdx
@@ -176,11 +176,11 @@ To refer to an individual instance of a resource created using the `count` meta-
 
 <Tip>
 
-You can use the `count` argument as a conditional for creating resources. For example, setting a `count = var.creator ? 3 : 0` instructs Terraform to create three instances of the resource when a variable named `creator` is set to `true`. Refer to [​​Conditional Expressions](/terraform/language/expressions/conditionals) for additional information.
+You can use the `count` argument as a conditional for creating resources. For example, setting a `count = var.creator ? 3 : 0` instructs Terraform to create three instances of the resource when a variable named `creator` is set to `true`. Refer to [​​Conditional Expressions](/terraform/language/expressions/conditionals) for more information.
 
 </Tip>
 
-The `count` argument is a meta-argument, which is built into Terraform and controls the way that Terraform creates resources. Refer to [Meta-arguments](/terraform/language/meta-arguments) for additional information.
+The `count` argument is a meta-argument, which is built into Terraform and controls the way that Terraform creates resources. Refer to [Meta-arguments](/terraform/language/meta-arguments) for more information.
 
 #### Summary
 
@@ -205,9 +205,9 @@ Use the `depends_on` argument when the resources do not reference each other. We
 When using the `depends_on` meta-argument, you can only reference other resources or child modules in the same root module. The list cannot include arbitrary expressions. Any values referenced in the `depends_on` list must be known before Terraform begins the operation so that it can evaluate dependencies.
 
 Specifying an entire module in the `depends_on` argument affects the order in which Terraform provisions all of the resources and data sources associated with that module. Refer to [Resource dependencies](/terraform/language/manage-resources#resource-dependencies) <!-- placeholder link -->
-and [Data resource dependencies](/terraform/language/configure-data-sources#data-resource-dependencies) for additional information.
+and [Data resource dependencies](/terraform/language/configure-data-sources#data-resource-dependencies) for more information.
 
-The `depends_on` argument is a meta-argument, which is built into Terraform and controls the way that Terraform creates resources. Refer to [Meta-arguments](/terraform/language/concepts/meta-arguments) for additional information.
+The `depends_on` argument is a meta-argument, which is built into Terraform and controls the way that Terraform creates resources. Refer to [Meta-arguments](/terraform/language/concepts/meta-arguments) for more information.
 
 #### Summary
 
@@ -252,7 +252,7 @@ You can use pure functions, such as `toset()` and `tomap()`, to create a map or
 
 Keys in the `for_each` argument cannot be the result of or rely on the result of impure functions, including `uuid`, `bcrypt`, or `timestamp`, because Terraform defers evaluating impure functions during the main evaluation step.
 
-The `for_each` argument does not implicitly convert lists or tuples to sets. To declare resource instances based on a nested data structure or combinations of elements from multiple data structures, you can use Terraform expressions and functions to derive a suitable value. Refer to the following examples for additional information:
+The `for_each` argument does not implicitly convert lists or tuples to sets. To declare resource instances based on a nested data structure or combinations of elements from multiple data structures, you can use Terraform expressions and functions to derive a suitable value. Refer to the following examples for more information:
 
 - [Transform a multi-level nested structure into a flat list](/terraform/language/functions/flatten#flattening-nested-structures-for-for_each).
 - [Combine collections to produce a list of element combinations](/terraform/language/functions/setproduct#finding-combinations-for-for_each).
@@ -261,7 +261,7 @@ You cannot use sensitive values, such as [sensitive input variables](/terraform/
 
 If you transform a value containing sensitive data into an argument for use in `for_each`, be aware that most functions in Terraform will return a sensitive result if given an argument with any sensitive content. In many cases, you can achieve similar results with a `for` expression. For example, to call `keys(local.map)` where `local.map` is an object with sensitive values, but non-sensitive keys, you can create a value to pass to `for_each` using `toset([for k,v in local.map : k])`.
 
-Refer to [Sensitive Data in State](/terraform/language/state/sensitive-data) for additional information. 
+Refer to [Sensitive Data in State](/terraform/language/state/sensitive-data) for more information. 
 
 The `for_each` argument exposes an `each` object that you can reference within the same block to modify specific instances of the resource. The object has the following attributes:
 
@@ -270,7 +270,7 @@ The `for_each` argument exposes an `each` object that you can reference within t
 
 Use the `<TYPE>.<NAME>[<KEY>]` syntax to access an instance of a resource created using `for_each`. For example, `azurerm_resource_group.rg["a_group"]` refers to an instance of the `azurrm_resource_group` resource named `rg` created off of the `a_group` key.
 
-The `for_each` argument is a meta-argument, which is built into Terraform and controls the way that Terraform creates resources. Refer to [Meta-arguments](/terraform/language/meta-arguments) for additional information.
+The `for_each` argument is a meta-argument, which is built into Terraform and controls the way that Terraform creates resources. Refer to [Meta-arguments](/terraform/language/meta-arguments) for more information.
 
 #### Summary
 
@@ -292,7 +292,7 @@ By default, Terraform automatically selects a provider based on the resource typ
 
 Use the `<PROVIDER>.<ALIAS>` syntax to reference a provider configuration in the `provider` argument. Refer to [Multiple Provider Configurations](/terraform/language/providers/configuration#alias-multiple-provider-configurations) for instructions on how to reference a specific provider configuration.     
 
-The `provider` argument is a meta-argument, which is built into Terraform and controls the way that Terraform creates resources. Refer to [Meta-arguments](/terraform/language/concepts/meta-arguments) for additional information.
+The `provider` argument is a meta-argument, which is built into Terraform and controls the way that Terraform creates resources. Refer to [Meta-arguments](/terraform/language/concepts/meta-arguments) for more information.
 
 #### Summary
 
@@ -318,12 +318,12 @@ You can specify the following lifecycle rules to manage how Terraform performs o
 - [`prevent_destroy`](#prevent_destroy): Terraform rejects operations to destroy the resource and returns an error.
 - [`ignore_changes`](#ignore_changes):  Specifies a list of resource attributes that Terraform ignores changes to. Otherwise, Terraform attempts to update the actual resource to match the configuration.  
 - [`replace_triggered_by`](#replace-triggered_by): Terraform replaces the resource when any of the referenced resources or specified attributes change.
-- [`precondition`](#precondition): Specifies a condition that Terraform evaluates before creating the resource. Refer to [Test and validate](/terraform/language/test-and-validate) for additional information.
-- [`postcondition`](#postcondition): Specifies a condition that Terraform evaluates after creating the resource. Refer to [Test and validate](/terraform/language/test-and-validate) for additional information.
+- [`precondition`](#precondition): Specifies a condition that Terraform evaluates before creating the resource. Refer to [Test and validate](/terraform/language/test-and-validate) for more information.
+- [`postcondition`](#postcondition): Specifies a condition that Terraform evaluates after creating the resource. Refer to [Test and validate](/terraform/language/test-and-validate) for more information.
 
 Configurations defined in the `lifecycle` block affect how Terraform constructs and traverses the dependency graph. You can only use literal values in the lifecycle block because Terraform processes them before it evaluates arbitrary expressions for a run.
 
-The `lifecycle` block is a meta-argument. Meta-arguments are built-in arguments that control how Terraform creates resources. Refer to [Meta-arguments](/terraform/language/concepts/meta-arguments) for additional information.  
+The `lifecycle` block is a meta-argument. Meta-arguments are built-in arguments that control how Terraform creates resources. Refer to [Meta-arguments](/terraform/language/concepts/meta-arguments) for more information.  
 
 #### Summary
 
@@ -508,7 +508,7 @@ The `connection` block specifies settings that let provisioners connect to resou
 
 <Warning>
 
-We recommend using configuration management tools or other means to perform actions on the local or remote machine instead of using provisioners. Refer to [Perform post-apply action](#)<!--TODO: updated with real link when ready--> for additional information.
+We recommend using configuration management tools or other means to perform actions on the local or remote machine instead of using provisioners. Refer to [Perform post-apply action](#)<!--TODO: updated with real link when ready--> for more information.
 
 </Warning>
 
@@ -539,7 +539,7 @@ resource {
 
 Terraform does not validate SSH host keys by default. You can establish a separate mechanism for key distribution and explicitly set the `host_key` argument to verify against a specific key or signing CA.
 
-You can use ephemeral values for arguments in the `connection` block. Refer [Ephemerality in resources](/terraform/language/resources/ephemeral) for additional information.
+You can use ephemeral values for arguments in the `connection` block. Refer [Ephemerality in resources](/terraform/language/resources/ephemeral) for more information.
 
 Expressions in `connection` blocks cannot refer to their parent resource by name. References create dependencies, and referring to a resource by name within its own block would create a dependency cycle. Instead, use the `self` object in expressions to refer to the `connection` block's parent block, including all of its attributes. For example, use `self.public_ip` to reference the `public_ip` attribute in an `aws_instance`. 
 
@@ -561,13 +561,13 @@ The following table describes the arguments you can use in the `connection` bloc
 | `host` | Specifies the address of the resource to connect to. <p>This argument is required.</p> | string | `ssh`<p>`winrm`</p> | none |
 | `port` | Specifies the port number to connect to. | number | `ssh`<p>`winrm`</p> | <p>`22` when `type` is `ssh`</p><p>`5985` when `type` is `winrm`</p> |
 | `timeout` | Specifies how long to wait for the connection to become available. | string | `ssh`<p>`winrm`</p> | `"5m"` |
-| `script_path` | Specifies the path on the remote resource where Terraform copies scripts to. Refer to the [`provisioner` block reference](#provisioner) for additional information. Terraform copies scripts to a path that contains random numbers depending on the `target_platform` configuration. | string | `ssh`<p>`winrm`</p> | <p>`/tmp/terraform_%RAND%.sh` when `target_platform` is `unix`</p><p>`C:/windows/temp/`<br/>`terraform_%RAND%.cmd` when `target_platform` is `windows`</p> |
+| `script_path` | Specifies the path on the remote resource where Terraform copies scripts to. Refer to the [`provisioner` block reference](#provisioner) for more information. Terraform copies scripts to a path that contains random numbers depending on the `target_platform` configuration. | string | `ssh`<p>`winrm`</p> | <p>`/tmp/terraform_%RAND%.sh` when `target_platform` is `unix`</p><p>`C:/windows/temp/`<br/>`terraform_%RAND%.cmd` when `target_platform` is `windows`</p> |
 | `private_key` | Specifies the contents of an SSH key to use for the connection. `private_key` takes precedence over `password` when both are provided. | <p>string</p><p>Use a [`file` function](/terraform/language/functions/file) to load keys from file.</p> | `ssh` | none |
 | `certificate` | Specifies the contents of a signed CA certificate. You must also configure a  `private_key` arugment. | <p>string</p><p>Use a [`file` function](/terraform/language/functions/file) to load certificates from file.</p> | `ssh` | none |
 | `agent` | Specifies an SSH agent for authentication. Set to `false` to disable using `ssh-agent` to authenticate. On Windows, the only supported SSH authentication agent is [Pageant](http://the.earth.li/\~sgtatham/putty/0.66/htmldoc/Chapter9.html#pageant). | string | `ssh` | `false` |
 | `agent_identity` | Specifies the preferred identity from the SSH agent to use for authentication. | string | `ssh` | none |
 | `host_key` | Specifies the public key from the remote host or the signing CA to verify the connection. | string | `ssh` | none |
-| `target_platform` | Specifies the target platform, which affects the default value for the `script_path` argument. You can specify either `windows` or `unix`. <p>`windows` sets the default `script_path` to `c:\windows\temp\terraform_%RAND%.cmd` if the default SSH shell on the remote resource is `cmd.exe`. Refer to the [Windows documentation](https://docs.microsoft.com/en-us/windows-server/administration/openssh/openssh_server_configuration#configuring-the-default-shell-for-openssh-in-windows) for additional information. If the SSH default shell is PowerShell, set `script_path` to `"c:/windows/temp/terraform_%RAND%.ps1"`.</p><p>`unix` sets the default `script_path` to `/tmp/terraform_%RAND%.sh`. </p> | string | `ssh` |`unix` |
+| `target_platform` | Specifies the target platform, which affects the default value for the `script_path` argument. You can specify either `windows` or `unix`. <p>`windows` sets the default `script_path` to `c:\windows\temp\terraform_%RAND%.cmd` if the default SSH shell on the remote resource is `cmd.exe`. Refer to the [Windows documentation](https://docs.microsoft.com/en-us/windows-server/administration/openssh/openssh_server_configuration#configuring-the-default-shell-for-openssh-in-windows) for more information. If the SSH default shell is PowerShell, set `script_path` to `"c:/windows/temp/terraform_%RAND%.ps1"`.</p><p>`unix` sets the default `script_path` to `/tmp/terraform_%RAND%.sh`. </p> | string | `ssh` |`unix` |
 | `https` | Set to `true` to connect using HTTPS instead of HTTP. | boolean | `winrm` | `false` |
 | `insecure` | Set to `true` to skip validating the HTTPS certificate chain. | boolean | `winrm` | `false` |
 | `use_ntlm` | Set to `true` to use NTLM authentication instead of basic authentication. Using NTLM removes the requirement for basic authentication to be enabled within the target guest. Refer to [Authentication for Remote Connections](https://docs.microsoft.com/en-us/windows/win32/winrm/authentication-for-remote-connections) in the Windows App Development documentation for more details. | boolean | `winrm` | `false` |
@@ -605,7 +605,7 @@ resource {
 
 <Warning>
 
-We recommend using configuration management tools or other means to perform actions on the local or remote machine instead of using the `provisioner` block. Refer to [Perform post-apply action](#)<!--TODO: updated with real link when ready--> for additional information.
+We recommend using configuration management tools or other means to perform actions on the local or remote machine instead of using the `provisioner` block. Refer to [Perform post-apply action](#)<!--TODO: updated with real link when ready--> for more information.
 
 </Warning>
 
@@ -727,7 +727,7 @@ resource {
 }
 ```
 
-Terraform evaluates the command in a local shell and can use environment variables for variable substitution. We do not recommend using Terraform variables for variable substitution because doing so can lead to shell injection vulnerabilities. Instead, use the `environment` parameter and environment variable substitution. Refer to the following OWASP article for additional information about injection flaws: [Code Injection](https://owasp.org/www-community/attacks/Code_Injection).
+Terraform evaluates the command in a local shell and can use environment variables for variable substitution. We do not recommend using Terraform variables for variable substitution because doing so can lead to shell injection vulnerabilities. Instead, use the `environment` parameter and environment variable substitution. Refer to the following OWASP article for more information about injection flaws: [Code Injection](https://owasp.org/www-community/attacks/Code_Injection).
 
 #### Summary
 

From fdd5184994eb3aa2256b7a780a73633a08c130c1 Mon Sep 17 00:00:00 2001
From: trujillo-adam <ajosetru@gmail.com>
Date: Wed, 30 Apr 2025 16:22:03 -0700
Subject: [PATCH 10/12] additional updates from review

---
 website/docs/language/block/resource.mdx | 27 ++++++++++--------------
 1 file changed, 11 insertions(+), 16 deletions(-)

diff --git a/website/docs/language/block/resource.mdx b/website/docs/language/block/resource.mdx
index e61223db3818..e0a695ec06e8 100644
--- a/website/docs/language/block/resource.mdx
+++ b/website/docs/language/block/resource.mdx
@@ -13,7 +13,7 @@ The `resource` block defines a piece of infrastructure and specifies the setting
 The `resource` block supports the following arguments:
 
 - [`resource "<TYPE>" "<LABEL>"`](#resource) &nbsp; block
-   - [Provider-specific arguments](#provider-specific-arguments) &nbsp; block | refer to your provider documentation
+   - [`PROVIDER ARGUMENTS`](#provider-arguments) &nbsp; block | refer to your provider documentation
    - [`count`](#count) &nbsp; number | mutually exclusive with `for_each`
    - [`depends_on`](#depends_on) &nbsp; list of references
    - [`for_each`](#for_each) &nbsp; map or set of strings | mutually exclusive with `count`
@@ -149,12 +149,12 @@ A `resource` block supports the following configuration.
 
 You must set the following arguments for every `resource` block: 
 
-- `TYPE`: Specifies the type of resource. This value is determined by the provider developer. Refer to provider documentation for details. The `terraform_data` resource type, which you can use to store values and trigger Terraform operations without creating actual infrastructure, is the exception. 
+- `TYPE`: Specifies the type of resource to create. You can declare either a resource type determined by the provider or the built-in `terraform_data` resource type, which stores values and triggers Terraform operations without creating actual infrastructure. For information about provider resource types, refer to the provider documentation. 
 - `LABEL`: Specifies a name for the resource. Terraform uses this label to track the resource in your state file. The label does not affect settings on the actual infrastructure resource. Refer to [References to Named Values](/terraform/language/expressions/references) and [Resource naming](/terraform/language/style#resource-naming) for expression syntax and label recommendations.
 
 To reference the resource in your configuration, you must refer to it using `<TYPE>.<LABEL>` syntax. 
 
-### Provider-specific arguments
+### `PROVIDER ARGUMENTS`
 
 The provider developer determines which arguments you can define for a resource. Refer to the provider documentation for details.  
 
@@ -346,7 +346,7 @@ By default, Terraform destroys a resource before creating a replacement.
 
 Refer to the documentation for the resource type you are configuring to understand which changes Terraform can make in-place and which require recreating the resource to decide whether to use the `create_before_destroy` argument. 
 
-Terraform propagates and applies the `create_before_destroy` behavior to all upstream resources. For example, if `create_before_destroy` is enabled on resource A but not on resource B, but resource A is dependent on resource B, then Terraform enables `create_before_destroy` for resource B implicitly and records it in the state file. You cannot override `create_before_destroy` to `false` on resource B because that would imply dependency cycles in the graph.
+Terraform propagates and applies the `create_before_destroy` behavior to all resource dependencies. For example, if `create_before_destroy` is enabled on resource A but not on resource B, but resource A is dependent on resource B, then Terraform enables `create_before_destroy` for resource B implicitly and records it in the state file. You cannot override `create_before_destroy` to `false` on resource B because that would imply dependency cycles in the graph.
 
 Setting`create_before_destroy` to `true` on a resource stops any configured destroy provisioners. 
 
@@ -644,7 +644,7 @@ resource {
 ```
 
 
-You can specify a string value that contains an expression. You can't use the `source` argument and the [`content`](#content) argument in the same `provisioner "file"` block. 
+You can specify a string value that contains an expression. You cannot use the `source` argument and the [`content`](#content) argument in the same `provisioner "file"` block. 
 
 When the `source` argument specifies a directory and the `type` argument in the [provisioner connection settings](#connection) is set to `ssh`, the corresponding directory specified in the `destination` argument must already exist. You can add a `provisioner "remote-exec"` block to your `resource` configuration to create the directory. If the directory does not already exist, Terraform creates it when the `type` argument in the [provisioner connection settings](#connection) is set to `winrm`.
 
@@ -673,7 +673,7 @@ resource {
 
 When `destination` points to a file, Terraform writes the value of the `content` argument to the file. When `destination` points to a directory, Terraform creates a file named `tf-file-content` inside the directory. We recommend setting the `destination` argument to a file when using `content` argument. Do not use the `content` argument and the [`source`](#source) argument in the same `provisioner "file"` block. 
 
-You can specify a string value that contains an expression. You can't use the `source` argument and the [`content`](#content) argument in the same `provisioner "file"` block. 
+You can specify a string value that contains an expression. You canot use the `source` argument and the [`content`](#content) argument in the same `provisioner "file"` block. 
 
 #### Summary
 
@@ -944,9 +944,10 @@ resource "aws_iam_user" "deploy_user" {
 
 ### Specify a dependency
 
-The examples in this section show how to specify resource dependencies.
 
-The following `resource` block partially defines an `aws_iam_role` resource. Refer to the [AWS provider documentation](https://registry.terraform.io/providers/hashicorp/aws/latest/docs/resources/iam_role) for all configuration settings. The `aws_iam_instance_profile` resource references the `aws_iam_role` resource, instructing Terraform to create the upstream resource first. 
+In the following example, the `aws_iam_instance_profile` resource references the `aws_iam_role` resource, instructing Terraform to create the upstream resource first. The `aws_iam_role_policy` resource configures an IAM policy that lets the EC2 instance access the S3 API.
+
+Terraform infers that it must create the instance profile before the EC2 instance, but it cannot infer that the software running in the EC2 instance needs access to the S3 API in order to boot properly. As a result, the configuration explicitly instructs Terraform to create the `aws_iam_role_policy` first:
 
 ```hcl
 resource "aws_iam_role" "example" {
@@ -957,11 +958,7 @@ resource "aws_iam_role" "example" {
 resource "aws_iam_instance_profile" "example" {
   role = aws_iam_role.example.name
 }
-```
 
-The following `resource` block configures an IAM policy that lets the EC2 instance access the S3 API.
-
-```hcl
 resource "aws_iam_role_policy" "example" {
   name   = "example"
   role   = aws_iam_role.example.name
@@ -972,11 +969,7 @@ resource "aws_iam_role_policy" "example" {
     }],
   })
 }
-```
-
-Terraform infers that it must create the instance profile before the EC2 instance, but it cannot infer that the software running in the EC2 instance needs access to the S3 API in order to boot properly. As a result, the configuration explicitly instructs Terraform to create the `aws_iam_role_policy` first:
 
-```hcl
 resource "aws_instance" "example" {
   ami           = "data.aws_ami.example.id"
   instance_type = "t2.micro"
@@ -991,6 +984,8 @@ data "aws_ami" "example" {
 }
 ```
 
+Note that the `aws_iam_role` resource is partially defined. Refer to the [AWS provider documentation](https://registry.terraform.io/providers/hashicorp/aws/latest/docs/resources/iam_role) for all configuration settings.
+
 ### Select an alternate provider configuration
 
 In the following example, the `google_compute_instance` resource selects the provider configuration with the `europe` alias. 

From b7d3b099a4fa7f02a36b8ce3310655a62800ff14 Mon Sep 17 00:00:00 2001
From: trujillo-adam <ajosetru@gmail.com>
Date: Thu, 15 May 2025 11:41:50 -0700
Subject: [PATCH 11/12] fixes a few mistakes in the resource block ref

---
 website/docs/language/block/resource.mdx | 71 +++++++++++++++++++++++-
 1 file changed, 68 insertions(+), 3 deletions(-)

diff --git a/website/docs/language/block/resource.mdx b/website/docs/language/block/resource.mdx
index e0a695ec06e8..8ba31f32defe 100644
--- a/website/docs/language/block/resource.mdx
+++ b/website/docs/language/block/resource.mdx
@@ -59,7 +59,7 @@ The `resource` block supports the following arguments:
         - [`proxy_port`](#connection-arguments) &nbsp; string
         - [`proxy_user_name`](#connection-arguments) &nbsp; string
         - [`proxy_user_password`](#connection-arguments) &nbsp; string
-   - [`provisioner "<TYPE>" "<LABEL>"`](#provisioner) &nbsp; block
+   - [`provisioner "<TYPE>"`](#provisioner) &nbsp; block
       - [`source`](#source) &nbsp; string
       - [`destination`](#destination) &nbsp; string
       - [`content`](#content) &nbsp; string      
@@ -111,7 +111,7 @@ resource "<TYPE>" "<LABEL>" {
     host = <EXPRESSION>
     <DEFAULT_CONNECTION_SETTINGS>
   }
-  provisioner "<TYPE>" "<LABEL>" {
+  provisioner "<TYPE>" {
     source = "<PATH>"
     destination = "<PATH>"
     content = "<CONTENT TO COPY TO `destination`>"
@@ -597,7 +597,7 @@ The `provisioner` block defines actions to perform on the local machine or creat
 
 ```hcl
 resource {
-  provisioner "<TYPE>" "<LABEL>" {
+  provisioner "<TYPE>" {
     <arguments> 
   }
 }
@@ -719,6 +719,7 @@ Modern Windows systems support running an OpenSSH server, so we strongly recomme
 ### `command`
 
 The `command` argument specifies a command for a local executable to run. You can specify an absolute path or a relative path to the current working directory. 
+
 ```hcl
 resource {
   provisioner "local-exec" "<LABEL>" {
@@ -837,6 +838,70 @@ When `quiet` is set to `true`, Terraform prints `"Suppressed by quiet=true"` to
 - Data type: Boolean.
 - Default: None.
 
+
+### `inline` 
+
+Specifies a list of command strings for the remote resource to run.
+
+
+```hcl
+resource {
+  # ...
+  provisioner "remote-exec" {
+    inline = [ "<command>" ]
+  }
+}
+```
+The provisioner uses the remote resource's default shell unless you specify a shell as the first command, for example `#!/bin/bash`. You cannot add an `inline` argument in the same provisioner with `script` or `scripts`.
+
+#### Summary
+
+- Data type: List.
+- Default: None.
+
+### `script`
+
+Specifies the relative or absolute path to a script on the local machine to copy and execute on the remote resource.  
+
+
+```hcl
+resource {
+  # ...
+  provisioner "remote-exec" {
+    scripts = "<path-to-script>"
+  }
+}
+```
+
+You cannot add a `script` argument in the same provisioner with `inline` or `scripts`.
+
+#### Summary
+
+- Data type: String.
+- Default: None.
+
+### `scripts`
+
+Specifies a list of relative or absolute paths to scripts on the local machine to copy and execute on the remote resource.  
+
+
+```hcl
+resource {
+  # ...
+  provisioner "remote-exec" {
+    scripts = [ "<path-to-script>" ]
+  }
+}
+```
+
+You cannot add a `scripts` argument in the same provisioner with `inline` or `script`.
+
+#### Summary
+
+- Data type: List.
+- Default: None.
+
+
 ## Examples
 
 The following examples show how to write configuration for common use cases.

From fe37cf1a990a1fbcc30bb00edce52c78eed20b99 Mon Sep 17 00:00:00 2001
From: trujillo-adam <47586768+trujillo-adam@users.noreply.github.com>
Date: Mon, 19 May 2025 12:56:19 -0700
Subject: [PATCH 12/12] Apply suggestions from code review

Co-authored-by: rita <8647768+ritsok@users.noreply.github.com>
---
 website/docs/language/block/resource.mdx | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/website/docs/language/block/resource.mdx b/website/docs/language/block/resource.mdx
index 8ba31f32defe..3dccd07704aa 100644
--- a/website/docs/language/block/resource.mdx
+++ b/website/docs/language/block/resource.mdx
@@ -841,7 +841,7 @@ When `quiet` is set to `true`, Terraform prints `"Suppressed by quiet=true"` to
 
 ### `inline` 
 
-Specifies a list of command strings for the remote resource to run.
+Specifies a list of command strings to execute on the remote resource.
 
 
 ```hcl
@@ -882,7 +882,7 @@ You cannot add a `script` argument in the same provisioner with `inline` or `scr
 
 ### `scripts`
 
-Specifies a list of relative or absolute paths to scripts on the local machine to copy and execute on the remote resource.  
+Specifies a list of relative or absolute paths to script files on the local machine to copy and execute on the remote resource.  
 
 
 ```hcl