From 5b9d68215c54c5a67440094693f7af4fd684a58c Mon Sep 17 00:00:00 2001 From: Brian Flad Date: Mon, 25 Jul 2022 15:47:59 -0400 Subject: [PATCH] plugin/how-terraform-works: Further clarify nested attributes benefits Reference: https://github.com/hashicorp/terraform-plugin-framework/issues/214 Reference: https://github.com/hashicorp/terraform-plugin-sdk/pull/819 Reference: https://github.com/hashicorp/terraform-plugin-sdk/issues/201 As part of investigating some differences between sdk/v2 and framework, the individual sensitivity configuration offered by nested attributes in protocol version 6 is important to call out explicitly. --- website/docs/plugin/how-terraform-works.mdx | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/website/docs/plugin/how-terraform-works.mdx b/website/docs/plugin/how-terraform-works.mdx index 1d8dc40e9..da985f816 100644 --- a/website/docs/plugin/how-terraform-works.mdx +++ b/website/docs/plugin/how-terraform-works.mdx @@ -123,7 +123,9 @@ Major versions of the protocol delineate Terraform CLI and Terraform Plugin comp Protocol version 6 is compatible with Terraform CLI version 1.0 and later. Protocol version 6 includes all version 5 functionality for providers, plus: -* **Nested Attributes**: You can define `SchemaAttribute` with the `NestedType` field. This enables complex schemas using [argument syntax](/language/syntax/configuration#arguments) instead of [block syntax](/language/syntax/configuration#blocks) and is preferred going forward. +* **Nested Attributes**: Define `SchemaAttribute` with the `NestedType` field. + * Enable practitioners to use easier [argument syntax](/language/syntax/configuration#arguments) instead of [block syntax](/language/syntax/configuration#blocks). + * Configure value sensitivity on individual nested attributes, rather than an entire read-only (`Computed` only) attribute. Implementations include: