add example in doc and remove comments

Author: nkonjeti

datadog/fwprovider/resource_datadog_custom_framework.go

@@ -162,21 +162,6 @@ func (r *customFrameworkResource) Read(ctx context.Context, request resource.Rea
 	data, _, err := r.Api.GetCustomFramework(r.Auth, state.Handle.ValueString(), state.Version.ValueString())
 	// If the framework does not exist, remove it from terraform state
 	// This is to avoid the provider to return an error when the framework is deleted in the UI prior
-
-	// DELETE example:
-	// 1. create the framework in terraform
-	// 2. delete the framework in the UI
-	// 3. run terraform plan
-	// 4. terraform will see that the framework does not exist so it will remove it from the state
-	// 5. no changes are calculated by terraform so nothing is updated
-
-	// UPDATE example:
-	// 1. create the framework in terraform
-	// 2. delete the framework in the UI
-	// 3. update the framework in terraform
-	// 4. run terraform plan
-	// 5. terraform will see that the framework does not exist so it will remove it from the state
-	// 6. terraform will perform a create action for the framework
 	if err != nil && err.Error() == "400 Bad Request" {
 		// Clear the state completely
 		response.State.RemoveResource(ctx)

docs/resources/custom_framework.md

@@ -10,7 +10,28 @@ description: |-
 
 Manages custom framework in Datadog.
 
-
+## Example Usage
+
+```terraform
+resource "datadog_custom_framework" "example4" {
+  version     = "1"
+  handle      = "new-terraform-framework-handle"
+  name        = "new-terraform-framework"
+  icon_url    = "https://example.com/icon.png"
+  description = "This is a test I created this resource through terraform"
+  requirements {
+    name = "requirement1"
+    controls {
+      name     = "new-control"
+      rules_id = ["def-000-be9", "def-000-cea"]
+    }
+    controls {
+      name     = "new-control"
+      rules_id = ["def-000-be9"]
+    }
+  }
+}
+```
 
 <!-- schema generated by tfplugindocs -->
 ## Schema
@@ -40,7 +61,7 @@ Required:
 
 Optional:
 
-- `controls` (Block Set) The controls of the requirement. (see [below for nested schema](#nestedblock--requirements--controls))
+- `controls` (Block Set) The controls of the requirement. At least one control is required. (see [below for nested schema](#nestedblock--requirements--controls))
 
 <a id="nestedblock--requirements--controls"></a>
 ### Nested Schema for `requirements.controls`
@@ -55,5 +76,5 @@ Required:
 Import is supported using the following syntax:
 
 ```shell
-terraform import datadog_custom_framework.example2 "new-terraform-framework-test-2"
+terraform import datadog_custom_framework.example3 "terraform-created-framework-handle-1.0.0"
 ```