diff --git a/helper/schema/schema.go b/helper/schema/schema.go
index 7b2374051b2..1fe0b2f2231 100644
--- a/helper/schema/schema.go
+++ b/helper/schema/schema.go
@@ -295,12 +295,12 @@ const (
 	SchemaConfigModeBlock
 )
 
-// SchemaDiffSuppressFunc is a function which can be used to determine
-// whether a detected diff on a schema element is "valid" or not, and
-// suppress it from the plan if necessary.
+// SchemaDiffSuppressFunc is a function which can be used to analyze the diff
+// between the value of remote resource and stored state to suppress update of
+// schema element from the plan if necessary.
 //
 // Return true if the diff should be suppressed, false to retain it.
-type SchemaDiffSuppressFunc func(k, oldValue, newValue string, d *ResourceData) bool
+type SchemaDiffSuppressFunc func(k, remote, state string, d *ResourceData) bool
 
 // SchemaDefaultFunc is a function called to return a default value for
 // a field.