Update description metadata per PR feedback

website/docs/language/data-sources/index.html.md

@@ -3,7 +3,7 @@ layout: "language"
 page_title: "Data Sources - Configuration Language"
 sidebar_current: "docs-config-data-sources"
 description: |-
-Data sources allow Terraform to use external data, function output, and data from separate configurations. Learn about data resource arguments, behavior, dependencies, meta-arguments, and lifecycle.
+Data sources allow Terraform to use external data, function output, and data from other configurations. Terraform accesses them via data resources.
 ---
 
 # Data Sources

website/docs/language/expressions/conditionals.html.md

@@ -2,7 +2,7 @@
 layout: "language"
 page_title: "Conditional Expressions - Configuration Language"
 description: |-
-  Use conditional expressions in configurations to select one of two values. They are commonly used to define defaults to replace invalid values.
+  Conditional expressions in configurations select one of two values. You can use them to define defaults to replace invalid values.
 ---
 
 # Conditional Expressions

website/docs/language/expressions/dynamic-blocks.html.md

@@ -2,7 +2,7 @@
 layout: "language"
 page_title: "Dynamic Blocks - Configuration Language"
 description: |-
-  Use `dynamic` blocks in configurations to dynamically construct multi-level, nested block structures.
+  `dynamic` blocks dynamically construct multi-level, nested block structures. Learn to configure `dynamic` blocks and understand their behavior. 
 ---
 
 

website/docs/language/expressions/for.html.md

@@ -2,7 +2,7 @@
 layout: "language"
 page_title: "For Expressions - Configuration Language"
 description: |-
-  Using `for` expressions in Terraform configurations.
+  `for` expressions transform complex input values into complex output values. Learn how Terraform orders elements and how to filter inputs and group results.
 ---
 
 # `for` Expressions

website/docs/language/expressions/function-calls.html.md

@@ -2,7 +2,7 @@
 layout: "language"
 page_title: "Function Calls - Configuration Language"
 description: |-
-  Using function calls in Terraform configurations.
+  Function calls transform and combine values. Learn about Terraform's built-in functions.
 ---
 
 # Function Calls

website/docs/language/expressions/index.html.md

@@ -2,7 +2,7 @@
 layout: "language"
 page_title: "Expressions - Configuration Language"
 description: |-
-  An overview of expressions used to compute values in Terraform configurations.
+  An overview of expressions you can use to reference or compute values in Terraform configurations, including types, operators, and functions.
 ---
 
 # Expressions

website/docs/language/expressions/operators.html.md

@@ -2,7 +2,7 @@
 layout: "language"
 page_title: "Operators - Configuration Language"
 description: |-
-  Using operators in Terraform configurations.
+  Operators transform or combine expressions. Learn about arithmetic, logical, equality, and comparison operators.
 ---
 
 # Arithmetic and Logical Operators

website/docs/language/expressions/references.html.md

@@ -2,7 +2,7 @@
 layout: "language"
 page_title: "References to Values - Configuration Language"
 description: |-
-  Using references to values in Terraform configurations.
+  Reference named values in configurations, including resources, input variables, local and block-local values, module outputs, data sources, and workspace data.
 ---
 
 # References to Named Values

website/docs/language/expressions/splat.html.md

@@ -2,7 +2,7 @@
 layout: "language"
 page_title: "Splat Expressions - Configuration Language"
 description: |-
-  Using splat expressions in Terraform configurations.
+  Splat expressions concisely express common operations. They also transform single, non-null values into a single-element tuple.
 ---
 
 # Splat Expressions
@@ -63,9 +63,7 @@ tuple value. If the value is _null_ then the splat expression will return an
 empty tuple.
 
 This special behavior can be useful for modules that accept optional input
-variables whose default value is `null` to represent the absense of any value,
-to adapt the variable value to work with other Terraform language features that
-are designed to work with collections. For example:
+variables whose default value is `null` to represent the absence of any value. This allows the module to adapt the variable value for Terraform language features designed to work with collections. For example:
 
 ```
 variable "website" {

website/docs/language/expressions/strings.html.md

@@ -2,7 +2,7 @@
 layout: "language"
 page_title: "Strings and Templates - Configuration Language"
 description: |-
-  Using strings and templates in Terraform configurations.
+  String literals and template sequences interpolate values and manipulate text. Learn about both quoted and "heredoc" string syntax.
 ---
 
 # Strings and Templates

website/docs/language/expressions/type-constraints.html.md

@@ -3,8 +3,7 @@ layout: "language"
 page_title: "Type Constraints - Configuration Language"
 sidebar_current: "docs-config-types"
 description: |-
-  Terraform module authors and provider developers can use detailed type
-  constraints to validate the inputs of their modules and resources.
+  Learn how to use type constraints to validate user inputs to modules and resources.
 ---
 
 # Type Constraints

website/docs/language/expressions/types.html.md

@@ -2,7 +2,7 @@
 layout: "language"
 page_title: "Types and Values - Configuration Language"
 description: |-
-  An overview of values and their types in the Terraform language.
+  Learn about value types and their syntax, including string, number, bool, list, and map. Also learn about complex types and type conversion.
 ---
 
 # Types and Values

website/docs/language/expressions/version-constraints.html.md

@@ -2,7 +2,7 @@
 layout: "language"
 page_title: "Version Constraints - Configuration Language"
 description: |-
-  Using version constraints in Terraform configurations. 
+  Version constraint strings specify a range of acceptable versions for modules, providers, and Terraform itself. Learn version constraint syntax and behavior.  
 ---
 
 # Version Constraints

website/docs/language/files/index.html.md

@@ -2,7 +2,7 @@
 layout: "language"
 page_title: "Files and Directories - Configuration Language"
 description: |-
-  An overview of how Terraform configuration files are named, organized, and stored as well as how Terraform modules are created and evaluated.
+  Learn how to name, organize, and store Terraform configuration files as well as how Terraform evaluates modules.
 ---
 
 # Files and Directories

website/docs/language/files/override.html.md

@@ -3,7 +3,7 @@ layout: "language"
 page_title: "Override Files - Configuration Language"
 sidebar_current: "docs-config-override"
 description: |-
-  How Terraform override files merge additional settings into existing configuration objects.
+  Override files merge additional settings into existing configuration objects. Learn how to use override files and about merging behavior. 
 ---
 
 # Override Files

website/docs/language/functions/index.html.md

@@ -3,7 +3,7 @@ layout: "language"
 page_title: "Functions - Configuration Language"
 sidebar_current: "docs-config-functions"
 description: |-
-  An introduction to functions in the Terraform language that can transform and combine values.
+  An introduction to the built-in functions that you can use to transform and combine values in expressions.
 ---
 
 # Built-in Functions

website/docs/language/index.html.md

@@ -2,7 +2,7 @@
 layout: "language"
 page_title: "Overview - Configuration Language"
 description: |-
-  An introduction to the Terraform Configuration Language that is used to declare resources in infrastructure as code.
+You can use the Terraform language to write configuration files that tell Terraform how to manage a collection of infrastructure.
 ---
 
 # Terraform Language Documentation

website/docs/language/meta-arguments/count.html.md

@@ -2,7 +2,7 @@
 layout: "language"
 page_title: "The count Meta-Argument - Configuration Language"
 description: |-
-  Using the Terraform language `count` meta-argument to efficiently manage nearly identical resources without writing a separate block for each one.
+  The `count` meta-argument helps you efficiently manage nearly identical infrastructure resources without writing a separate block for each one.
 ---
 
 # The `count` Meta-Argument

website/docs/language/meta-arguments/depends_on.html.md

@@ -2,7 +2,7 @@
 layout: "language"
 page_title: "The depends_on Meta-Argument - Configuration Language"
 description: |-
-  Using the Terraform language `depends_on` meta-argument to handle hidden resource or module dependencies.
+  The `depends_on` meta-argument allows you to handle hidden resource or module dependencies.
 ---
 
 # The `depends_on` Meta-Argument

website/docs/language/meta-arguments/for_each.html.md

@@ -2,7 +2,7 @@
 layout: "language"
 page_title: "The for_each Meta-Argument - Configuration Language"
 description: |-
-  Using the Terraform language `for_each` meta-argument to efficiently manage similar resources without writing a separate block for each one.
+  The `for_each` meta-argument allows you to efficiently manage similar infrastructure resources without writing a separate block for each one.
 ---
 
 # The `for_each` Meta-Argument

website/docs/language/meta-arguments/lifecycle.html.md

@@ -2,7 +2,7 @@
 layout: "language"
 page_title: "The lifecycle Meta-Argument - Configuration Language"
 description: |-
-  Using the Terraform language `lifecycle` meta-argument to customize resource behavior. 
+  The meta-arguments in a `lifecycle` block allow you to customize resource behavior. For example, preventing Terraform from destroying associated infrastructure.
 ---
 
 # The `lifecycle` Meta-Argument

website/docs/language/meta-arguments/module-providers.html.md

@@ -2,7 +2,7 @@
 layout: "language"
 page_title: "The Module providers Meta-Argument - Configuration Language"
 description: |-
-  Using the Terraform language `providers` meta-argument to specify which provider configurations from a parent module are available inside a child module.
+  The `providers` meta-argument specifies which provider configurations from a parent module are available inside a child module.
 ---
 
 # The Module `providers` Meta-Argument

website/docs/language/meta-arguments/resource-provider.html.md

@@ -2,7 +2,7 @@
 layout: "language"
 page_title: "The Resource provider Meta-Argument - Configuration Language"
 description: |-
-  Using the Terraform language `provider` meta-argument to specify which provider configuration to use for a resource.
+  The `provider` meta-argument specifies which provider configuration Terraform should use for a resource.
 ---
 
 # The Resource `provider` Meta-Argument

website/docs/language/modules/develop/index.html.md

@@ -3,7 +3,7 @@ layout: "language"
 page_title: "Creating Modules"
 sidebar_current: "docs-modules"
 description: |-
-  An introduction to creating modules, containers for multiple resources that are used together in a Terraform configuration.
+  Modules are containers for multiple resources that are used together in a configuration. Learn when to create modules and about module structure.
 ---
 
 # Creating Modules

website/docs/language/modules/index.html.md

@@ -2,7 +2,7 @@
 layout: "language"
 page_title: "Modules Overview - Configuration Language"
 description: |-
-  An overview of Terraform modules, containers for multiple resources that are used together in a configuration.
+  Modules are containers for multiple resources that are used together in a configuration. Find resources for using, developing, and publishing modules.
 ---
 
 # Modules

website/docs/language/modules/sources.html.md

@@ -2,7 +2,8 @@
 layout: "language"
 page_title: "Module Sources"
 sidebar_current: "docs-modules-sources"
-description: Using `source` in Terraform modules to specify child modules in locations like GitHub, the Terraform Registry, Bitbucket, Git, Mercurial, S3, and GCS.
+description: |-
+  The `source` argument tells Terraform where to find child modules in locations like GitHub, the Terraform Registry, Bitbucket, Git, Mercurial, S3, and GCS.
 ---
 
 # Module Sources

website/docs/language/modules/syntax.html.md

@@ -3,7 +3,7 @@ layout: "language"
 page_title: "Modules - Configuration Language"
 sidebar_current: "docs-config-modules"
 description: |-
-  Calling one module from another in Terraform configurations.
+  Modules are containers for multiple resources that are used together. Learn how to call one module from another in configurations.
 ---
 
 # Module Blocks

website/docs/language/providers/configuration.html.md

@@ -3,12 +3,12 @@ layout: "language"
 page_title: "Provider Configuration - Configuration Language"
 sidebar_current: "docs-config-providers"
 description: |-
-  Configuring Terraform providers, including how to use the `alias` meta-argument to specify multiple configurations for a single provider.
+  Learn how to configure Terraform providers, including how to use the `alias` meta-argument to specify multiple configurations for a single provider.
 ---
 
 # Provider Configuration
 
-Providers alow Terraform to interact with cloud providers, SaaS providers, and
+Providers allow Terraform to interact with cloud providers, SaaS providers, and
 other APIs.
 
 Some providers require you to configure them with endpoint URLs, cloud regions,

website/docs/language/providers/requirements.html.md

@@ -2,7 +2,7 @@
 layout: "language"
 page_title: "Provider Requirements - Configuration Language"
 description: |-
-  Declaring providers in your module configuration so that Terraform can install them.
+  Providers are plugins that allow Terraform to interact with remote systems. Learn how to declare providers in your configuration.
 ---
 
 # Provider Requirements

website/docs/language/resources/behavior.html.md

@@ -2,7 +2,7 @@
 layout: "language"
 page_title: "Resource Behavior - Configuration Language"
 description: |-
-  How Terraform uses resource blocks to create infrastructure objects as well as details about resource attributes and dependencies.
+  Learn how Terraform uses `resource` blocks to create infrastructure objects.  Also learn about resource dependencies and accessing resource attributes.
 ---
 
 # Resource Behavior

website/docs/language/resources/index.html.md

@@ -2,7 +2,7 @@
 layout: "language"
 page_title: "Resources Overview - Configuration Language"
 description: |-
-  An introduction to the Terraform language resources element that is used to describe infrastructure objects.
+  An introduction to the `resources` element that  describes infrastructure objects in Terraform configurations.
 ---
 
 # Resources

website/docs/language/resources/provisioners/connection.html.md

@@ -3,7 +3,7 @@ layout: "language"
 page_title: "Provisioner Connection Settings"
 sidebar_current: "docs-provisioners-connection"
 description: |-
-  Managing provisioner connection defaults for SSH and WinRM using the `connection` block in Terraform language.
+  The `connection` block allows you to manage provisioner connection defaults for SSH and WinRM.
 ---
 
 # Provisioner Connection Settings