Update various comments for wording

Author: SBGoods

internal/fwschema/attribute.go

@@ -68,6 +68,8 @@ type Attribute interface {
 	// IsWriteOnly should return true if the attribute configuration value is
 	// write-only. This is named differently than WriteOnly to prevent a
 	// conflict with the tfsdk.Attribute field name.
+	//
+	// Write-only attributes are a managed-resource schema concept only.
 	IsWriteOnly() bool
 }
 

resource/schema/bool_attribute.go

@@ -153,9 +153,10 @@ type BoolAttribute struct {
 	// should be avoided and a plan modifier should be used instead.
 	Default defaults.Bool
 
-	// WriteOnly indicates that the practitioner can choose a value for this
-	// attribute, but Terraform will not store this attribute in state.
+	// WriteOnly indicates that Terraform will not store this attribute value
+	// in the plan or state artifacts.
 	// If WriteOnly is true, either Optional or Required must also be true.
+	// WriteOnly cannot be set with Computed.
 	//
 	// This functionality is only supported in Terraform 1.11 and later.
 	// Practitioners that choose a value for this attribute with older

resource/schema/dynamic_attribute.go

@@ -154,9 +154,10 @@ type DynamicAttribute struct {
 	// should be avoided and a plan modifier should be used instead.
 	Default defaults.Dynamic
 
-	// WriteOnly indicates that the practitioner can choose a value for this
-	// attribute, but Terraform will not store this attribute in state.
+	// WriteOnly indicates that Terraform will not store this attribute value
+	// in the plan or state artifacts.
 	// If WriteOnly is true, either Optional or Required must also be true.
+	// WriteOnly cannot be set with Computed.
 	//
 	// This functionality is only supported in Terraform 1.11 and later.
 	// Practitioners that choose a value for this attribute with older

resource/schema/float32_attribute.go

@@ -156,9 +156,10 @@ type Float32Attribute struct {
 	// should be avoided and a plan modifier should be used instead.
 	Default defaults.Float32
 
-	// WriteOnly indicates that the practitioner can choose a value for this
-	// attribute, but Terraform will not store this attribute in state.
+	// WriteOnly indicates that Terraform will not store this attribute value
+	// in the plan or state artifacts.
 	// If WriteOnly is true, either Optional or Required must also be true.
+	// WriteOnly cannot be set with Computed.
 	//
 	// This functionality is only supported in Terraform 1.11 and later.
 	// Practitioners that choose a value for this attribute with older

resource/schema/float64_attribute.go

@@ -156,9 +156,10 @@ type Float64Attribute struct {
 	// should be avoided and a plan modifier should be used instead.
 	Default defaults.Float64
 
-	// WriteOnly indicates that the practitioner can choose a value for this
-	// attribute, but Terraform will not store this attribute in state.
+	// WriteOnly indicates that Terraform will not store this attribute value
+	// in the plan or state artifacts.
 	// If WriteOnly is true, either Optional or Required must also be true.
+	// WriteOnly cannot be set with Computed.
 	//
 	// This functionality is only supported in Terraform 1.11 and later.
 	// Practitioners that choose a value for this attribute with older

resource/schema/int32_attribute.go

@@ -156,9 +156,10 @@ type Int32Attribute struct {
 	// should be avoided and a plan modifier should be used instead.
 	Default defaults.Int32
 
-	// WriteOnly indicates that the practitioner can choose a value for this
-	// attribute, but Terraform will not store this attribute in state.
+	// WriteOnly indicates that Terraform will not store this attribute value
+	// in the plan or state artifacts.
 	// If WriteOnly is true, either Optional or Required must also be true.
+	// WriteOnly cannot be set with Computed.
 	//
 	// This functionality is only supported in Terraform 1.11 and later.
 	// Practitioners that choose a value for this attribute with older

resource/schema/int64_attribute.go

@@ -156,9 +156,10 @@ type Int64Attribute struct {
 	// should be avoided and a plan modifier should be used instead.
 	Default defaults.Int64
 
-	// WriteOnly indicates that the practitioner can choose a value for this
-	// attribute, but Terraform will not store this attribute in state.
+	// WriteOnly indicates that Terraform will not store this attribute value
+	// in the plan or state artifacts.
 	// If WriteOnly is true, either Optional or Required must also be true.
+	// WriteOnly cannot be set with Computed.
 	//
 	// This functionality is only supported in Terraform 1.11 and later.
 	// Practitioners that choose a value for this attribute with older

resource/schema/list_attribute.go

@@ -169,9 +169,10 @@ type ListAttribute struct {
 	// should be avoided and a plan modifier should be used instead.
 	Default defaults.List
 
-	// WriteOnly indicates that the practitioner can choose a value for this
-	// attribute, but Terraform will not store this attribute in state.
+	// WriteOnly indicates that Terraform will not store this attribute value
+	// in the plan or state artifacts.
 	// If WriteOnly is true, either Optional or Required must also be true.
+	// WriteOnly cannot be set with Computed.
 	//
 	// This functionality is only supported in Terraform 1.11 and later.
 	// Practitioners that choose a value for this attribute with older

resource/schema/list_nested_attribute.go

@@ -179,9 +179,13 @@ type ListNestedAttribute struct {
 	// should be avoided and a plan modifier should be used instead.
 	Default defaults.List
 
-	// WriteOnly indicates that the practitioner can choose a value for this
-	// attribute, but Terraform will not store this attribute in state.
+	// WriteOnly indicates that Terraform will not store this attribute value
+	// in the plan or state artifacts.
 	// If WriteOnly is true, either Optional or Required must also be true.
+	// WriteOnly cannot be set with Computed.
+	//
+	// If WriteOnly is true for a nested attribute, all of its child attributes
+	// must also set WriteOnly to true and no child attribute can be Computed.
 	//
 	// This functionality is only supported in Terraform 1.11 and later.
 	// Practitioners that choose a value for this attribute with older

resource/schema/map_attribute.go

@@ -172,9 +172,10 @@ type MapAttribute struct {
 	// should be avoided and a plan modifier should be used instead.
 	Default defaults.Map
 
-	// WriteOnly indicates that the practitioner can choose a value for this
-	// attribute, but Terraform will not store this attribute in state.
+	// WriteOnly indicates that Terraform will not store this attribute value
+	// in the plan or state artifacts.
 	// If WriteOnly is true, either Optional or Required must also be true.
+	// WriteOnly cannot be set with Computed.
 	//
 	// This functionality is only supported in Terraform 1.11 and later.
 	// Practitioners that choose a value for this attribute with older