helper/schema: deprecate ResourceData.SetPartial()

helper/schema: deprecate ResourceData.Partial()

Author: appilon

helper/schema/resource_data.go

@@ -162,6 +162,9 @@ func (d *ResourceData) HasChange(key string) bool {
 // When partial state mode is enabled, then only key prefixes specified
 // by SetPartial will be in the final state. This allows providers to return
 // partial states for partially applied resources (when errors occur).
+//
+// Deprecated: Partial state has very limited benefit given Terraform refreshes
+// before operations by default.
 func (d *ResourceData) Partial(on bool) {
 	d.partial = on
 	if on {
@@ -211,6 +214,9 @@ func (d *ResourceData) Set(key string, value interface{}) error {
 //
 // If partial state mode is disabled, then this has no effect. Additionally,
 // whenever partial state mode is toggled, the partial data is cleared.
+//
+// Deprecated: Partial state has very limited benefit given Terraform refreshes
+// before operations by default.
 func (d *ResourceData) SetPartial(k string) {
 	if d.partial {
 		d.partialMap[k] = struct{}{}