update docs

apstra/blueprint/datacenter_generic_system.go

@@ -162,9 +162,13 @@ func (o DatacenterGenericSystem) ResourceAttributes() map[string]resourceSchema.
 			Validators: []validator.String{stringvalidator.OneOf(utils.AllNodeDeployModes()...)},
 		},
 		"clear_cts_on_destroy": resourceSchema.BoolAttribute{
-			MarkdownDescription: "When `true`, Link deletion in `destroy` phase and `apply` phase (where a Link has " +
-				"been removed from the configuration) will automatically clear Connectivity Template assignments " +
-				"from interfaces associated with those Links.",
+			MarkdownDescription: "When `true`, Connectivity Templates associated with this Generic System will be " +
+				"automatically cleared in a variety of circumstances where they would ordinarily block Generic System " +
+				"changes, including:\n" +
+				"  - Deletion of the Generic System\n" +
+				"  - Deletion of a Generic System Link or LAG interface\n" +
+				"  - Orphaning a LAG interface by reassigning all of its member links to new roles by changing their " +
+				"`group_label` attribute\n",
 			Optional: true,
 		},
 	}

docs/resources/datacenter_generic_system.md

@@ -84,7 +84,10 @@ resource "apstra_datacenter_generic_system" "example" {
 ### Optional
 
 - `asn` (Number) AS number of the Generic System. Note that in some circumstances Apstra may assign an ASN to the generic system even when none is supplied via this attribute. The automaticallyassigned value will be overwritten by Terraform during a subsequent apply operation.
-- `clear_cts_on_destroy` (Boolean) When `true`, Link deletion in `destroy` phase and `apply` phase (where a Link has been removed from the configuration) will automatically clear Connectivity Template assignments from interfaces associated with those Links.
+- `clear_cts_on_destroy` (Boolean) When `true`, Connectivity Templates associated with this Generic System will be automatically cleared in a variety of circumstances where they would ordinarily block Generic System changes, including:
+  - Deletion of the Generic System
+  - Deletion of a Generic System Link or LAG interface
+  - Orphaning a LAG interface by reassigning all of its member links to new roles by changing their `group_label` attribute
 - `deploy_mode` (String) Set the Apstra Deploy Mode for this Generic System. Default: `deploy`
 - `external` (Boolean) Set `true` to create an External Generic System
 - `hostname` (String) System hostname.