Added write-only as a descriptor, handled similarly to "sensitive"

internal/schemamd/behaviors.go

@@ -19,7 +19,7 @@
 	return att.Optional
 }
 
-// childBlockIsOptional returns true for blocks with with min items 0
+// childBlockIsOptional returns true for blocks with min items 0
 // which are either empty or have any required or optional children.
 func childBlockIsOptional(block *tfjson.SchemaBlockType) bool {
 	if block.MinItems > 0 {
@@ -77,3 +77,7 @@
 
 	return true
 }
+
+func childAttributeIsWriteOnly(att *tfjson.SchemaAttribute) bool {
+	return att.WriteOnly
+}

internal/schemamd/render.go

@@ -45,7 +45,7 @@ type groupFilter struct {
 }
 
 var (
-	// Attributes and Blocks are in one of 3 characteristic groups:
+	// Attributes and Blocks are in one of 4 characteristic groups:
 	// * Required
 	// * Optional
 	// * Read-Only

internal/schemamd/testdata/framework_types.md

@@ -26,6 +26,7 @@
 - `single_nested_block` (Block, Optional) example single nested block (see [below for nested schema](#nestedblock--single_nested_block))
 - `single_nested_block_sensitive_nested_attribute` (Block, Optional) example sensitive single nested block (see [below for nested schema](#nestedblock--single_nested_block_sensitive_nested_attribute))
 - `string_attribute` (String) example string attribute
+- `write_only_string_attribute` (String, Write-only) example write only string attribute
 
 ### Read-Only
 
@@ -123,4 +124,4 @@ Optional:
 Read-Only:
 
 - `set_nested_block_attribute` (String) example set nested block attribute
-- `set_nested_block_sensitive_attribute` (String, Sensitive) example sensitive set nested block attribute
+- `set_nested_block_sensitive_attribute` (String, Sensitive) example sensitive set nested block attribute

internal/schemamd/testdata/framework_types.schema.json

@@ -168,6 +168,13 @@
                 "description": "example string attribute",
                 "description_kind": "markdown",
                 "optional": true
+            },
+            "write_only_string_attribute": {
+                "type": "string",
+                "description": "example write only string attribute",
+                "description_kind": "markdown",
+                "optional": true,
+                "write_only": true
             }
         },
         "block_types": {

internal/schemamd/write_attribute_description.go

@@ -58,6 +58,13 @@ func WriteAttributeDescription(w io.Writer, att *tfjson.SchemaAttribute, include
 		}
 	}
 
+	if att.WriteOnly {
+		_, err := io.WriteString(w, ", Write-only")
+		if err != nil {
+			return err
+		}
+	}
+
 	_, err = io.WriteString(w, ")")
 	if err != nil {
 		return err

internal/schemamd/write_nested_attribute_type_description.go

@@ -97,6 +97,13 @@ func WriteNestedAttributeTypeDescription(w io.Writer, att *tfjson.SchemaAttribut
 		}
 	}
 
+	if att.WriteOnly {
+		_, err := io.WriteString(w, ", Write-only")
+		if err != nil {
+			return err
+		}
+	}
+
 	_, err = io.WriteString(w, ")")
 	if err != nil {
 		return err