diff --git a/docs/plugin-protocol/tfplugin5.6.proto b/docs/plugin-protocol/tfplugin5.6.proto
index c1c1301557c3..f07101126490 100644
--- a/docs/plugin-protocol/tfplugin5.6.proto
+++ b/docs/plugin-protocol/tfplugin5.6.proto
@@ -217,8 +217,8 @@ message Deferred {
   enum Reason {
     // UNKNOWN is the default value, and should not be used.
     UNKNOWN = 0;
-    // RESOURCE_CONFIG_UNKNOWN is used when parts of the resource configuration
-    // are unknown, e.g. the for_each value is only known after the apply is done.
+    // RESOURCE_CONFIG_UNKNOWN is used when the config is partially unknown and the real
+    // values need to be known before the change can be planned.
     RESOURCE_CONFIG_UNKNOWN = 1;
     // PROVIDER_CONFIG_UNKNOWN is used when parts of the provider configuration
     // are unknown, e.g. the provider configuration is only known after the apply is done.
diff --git a/docs/plugin-protocol/tfplugin6.6.proto b/docs/plugin-protocol/tfplugin6.6.proto
index dc6d246a07fe..580db9c1bdf7 100644
--- a/docs/plugin-protocol/tfplugin6.6.proto
+++ b/docs/plugin-protocol/tfplugin6.6.proto
@@ -236,8 +236,8 @@ message Deferred {
   enum Reason {
     // UNKNOWN is the default value, and should not be used.
     UNKNOWN = 0;
-    // RESOURCE_CONFIG_UNKNOWN is used when parts of the resource configuration
-    // are unknown, e.g. the for_each value is only known after the apply is done.
+    // RESOURCE_CONFIG_UNKNOWN is used when the config is partially unknown and the real
+    // values need to be known before the change can be planned.
     RESOURCE_CONFIG_UNKNOWN = 1;
     // PROVIDER_CONFIG_UNKNOWN is used when parts of the provider configuration
     // are unknown, e.g. the provider configuration is only known after the apply is done.