Apply suggestions from code review

Co-authored-by: Brian Flad <[email protected]>

Author: SBGoods

datasource/read.go

@@ -54,8 +54,8 @@ type ReadResponse struct {
 	// warnings or errors generated.
 	Diagnostics diag.Diagnostics
 
-	// Deferred indicates that Terraform should defer
-	// reading this data source.
+	// Deferred indicates that Terraform should defer reading this
+	// data source until a followup apply operation.
 	//
 	// This field can only be set if
 	// `(datasource.ReadRequest).ClientCapabilities.DeferralAllowed` is true.

resource/modify_plan.go

@@ -82,8 +82,8 @@ type ModifyPlanResponse struct {
 	// generated.
 	Diagnostics diag.Diagnostics
 
-	// Deferred indicates that Terraform should defer
-	// importing this resource.
+	// Deferred indicates that Terraform should defer importing this
+	// resource until a followup apply operation.
 	//
 	// This field can only be set if
 	// `(resource.ModifyPlanRequest).ClientCapabilities.DeferralAllowed` is true.

resource/read.go

@@ -67,8 +67,8 @@ type ReadResponse struct {
 	// warnings or errors generated.
 	Diagnostics diag.Diagnostics
 
-	// Deferred indicates that Terraform should defer
-	// importing this resource.
+	// Deferred indicates that Terraform should defer refreshing this
+	// resource until a followup plan operation.
 	//
 	// This field can only be set if
 	// `(resource.ReadRequest).ClientCapabilities.DeferralAllowed` is true.