Add Resource Plan Modification Example for Warnings on Destroy

[bflad]

Module version

v0.10.0

Use-cases

terraform-plugin-framework 0.10.0+ and Terraform 1.3+ support the ability for provider developers to return warning and/or error diagnostics when a resource is planned for destruction. The initial website documentation mentions the feature, but doesn't provide a quick code example. It'd be great to provide that.

Attempted Solutions

Figuring it out through trial and error or looking at other provider code.

Proposal

Add a quick subsection to https://www.terraform.io/plugin/framework/resources/plan-modification#resource-plan-modification that's specifically "Resource Destroy Plan Diagnostics" and something that shows req.Plan.IsNull() with resp.Diagnostics.AddWarning().

References

• Implement PlanResourceChange on Destroy Support #364
• https://www.terraform.io/plugin/framework/resources/plan-modification#resource-plan-modification

[github-actions]

I'm going to lock this issue because it has been closed for 30 days ⏳. This helps our maintainers find and focus on the active issues.
If you have found a problem that seems similar to this, please open a new issue and complete the issue template so we can capture all the details necessary to investigate further.