Merge pull request #56 from jetstack/cert_template_docs

Add docs for Certificate Template resources

Author: aidy

docs/resources/certificate_template.md

@@ -3,12 +3,18 @@
 page_title: "tlspc_certificate_template Resource - tlspc"
 subcategory: ""
 description: |-
-  
+  Manage Certificate Issuing Template
+  [!Note]Currently only a limited subset of attributes are supported.All Common Name/SAN/CSR validation fields are set to .* (allow all).Permitted Key Algorithms are set to RSA 2048/3072/4096.
 ---
 
 # tlspc_certificate_template (Resource)
 
+Manage Certificate Issuing Template
 
+> [!Note]
+> Currently only a limited subset of attributes are supported.
+> All Common Name/SAN/CSR validation fields are set to `.*` (allow all).
+> Permitted Key Algorithms are set to RSA 2048/3072/4096.
 
 ## Example Usage
 
@@ -26,10 +32,10 @@ resource "tlspc_certificate_template" "built_in" {
 
 ### Required
 
-- `ca_product_id` (String)
-- `ca_type` (String)
-- `key_reuse` (Boolean)
-- `name` (String)
+- `ca_product_id` (String) The ID of a Certificate Authority Product Option
+- `ca_type` (String) Type of Certificate Authority (see Certificate Authority Product Option data source)
+- `key_reuse` (Boolean) Allow Private Key Reuse
+- `name` (String) Name of the Certificate Issuing Template
 
 ### Read-Only
 

internal/provider/certificate_template_resource.go

@@ -37,6 +37,13 @@ func (r *certificateTemplateResource) Metadata(_ context.Context, req resource.M
 
 func (r *certificateTemplateResource) Schema(_ context.Context, _ resource.SchemaRequest, resp *resource.SchemaResponse) {
 	resp.Schema = schema.Schema{
+		MarkdownDescription: `Manage Certificate Issuing Template
+
+> [!Note]
+> Currently only a limited subset of attributes are supported.
+> All Common Name/SAN/CSR validation fields are set to ` + "`.*` (allow all)." + `
+> Permitted Key Algorithms are set to RSA 2048/3072/4096.
+`,
 		Attributes: map[string]schema.Attribute{
 			"id": schema.StringAttribute{
 				Computed: true,
@@ -45,16 +52,20 @@ func (r *certificateTemplateResource) Schema(_ context.Context, _ resource.Schem
 				},
 			},
 			"name": schema.StringAttribute{
-				Required: true,
+				Required:            true,
+				MarkdownDescription: "Name of the Certificate Issuing Template",
 			},
 			"ca_type": schema.StringAttribute{
-				Required: true,
+				Required:            true,
+				MarkdownDescription: "Type of Certificate Authority (see Certificate Authority Product Option data source)",
 			},
 			"ca_product_id": schema.StringAttribute{
-				Required: true,
+				Required:            true,
+				MarkdownDescription: "The ID of a Certificate Authority Product Option",
 			},
 			"key_reuse": schema.BoolAttribute{
-				Required: true,
+				Required:            true,
+				MarkdownDescription: "Allow Private Key Reuse",
 			},
 			/*
 				"key_types": schema.SetAttribute{