Add godoc note to stringvalidator

Author: SBGoods

stringvalidator/prefer_write_only_attribute.go

@@ -21,6 +21,9 @@ import (
 // This implements the validation logic declaratively within the schema.
 // Refer to [resourcevalidator.PreferWriteOnlyAttribute]
 // for declaring this type of validation outside the schema definition.
+//
+// NOTE: This validator will produce persistent warnings for practitioners on every Terraform run as long as the specified non-write-only attribute
+// has a value in the configuration. The validator will also produce warnings for users of shared modules who cannot immediately take action on the warning.
 func PreferWriteOnlyAttribute(writeOnlyAttribute path.Expression) validator.String {
 	return schemavalidator.PreferWriteOnlyAttribute{
 		WriteOnlyAttribute: writeOnlyAttribute,