From ee747c8e9ec54b1dea24e080c3eccbc61c6956f4 Mon Sep 17 00:00:00 2001
From: Chris Marget <cmarget@juniper.net>
Date: Sun, 15 Dec 2024 10:54:23 -0500
Subject: [PATCH] add `docCategoryAuthentication`

---
 apstra/constants.go                   | 15 ++++++++-------
 apstra/ephemeral_api_token.go         |  2 +-
 docs/ephemeral-resources/api_token.md |  4 ++--
 3 files changed, 11 insertions(+), 10 deletions(-)

diff --git a/apstra/constants.go b/apstra/constants.go
index 6cdd5a06..9b16acf1 100644
--- a/apstra/constants.go
+++ b/apstra/constants.go
@@ -19,11 +19,12 @@ const (
 	errBpClientCreateSummary                  = "Failed to create client for Blueprint %s"
 	errBpNotFoundSummary                      = "Blueprint %s not found"
 
-	docCategorySeparator    = " --- "
-	docCategoryDesign       = "Design" + docCategorySeparator
-	docCategoryResources    = "Resource Pools" + docCategorySeparator
-	docCategoryDatacenter   = "Reference Design: Datacenter" + docCategorySeparator
-	docCategoryFreeform     = "Reference Design: Freeform" + docCategorySeparator
-	docCategoryRefDesignAny = "Reference Design: Shared" + docCategorySeparator
-	docCategoryDevices      = "Devices" + docCategorySeparator
+	docCategorySeparator      = " --- "
+	docCategoryAuthentication = "Authentication" + docCategorySeparator
+	docCategoryDesign         = "Design" + docCategorySeparator
+	docCategoryResources      = "Resource Pools" + docCategorySeparator
+	docCategoryDatacenter     = "Reference Design: Datacenter" + docCategorySeparator
+	docCategoryFreeform       = "Reference Design: Freeform" + docCategorySeparator
+	docCategoryRefDesignAny   = "Reference Design: Shared" + docCategorySeparator
+	docCategoryDevices        = "Devices" + docCategorySeparator
 )
diff --git a/apstra/ephemeral_api_token.go b/apstra/ephemeral_api_token.go
index 145776de..19532b9d 100644
--- a/apstra/ephemeral_api_token.go
+++ b/apstra/ephemeral_api_token.go
@@ -31,7 +31,7 @@ func (o *ephemeralToken) Metadata(_ context.Context, req ephemeral.MetadataReque
 
 func (o *ephemeralToken) Schema(_ context.Context, _ ephemeral.SchemaRequest, resp *ephemeral.SchemaResponse) {
 	resp.Schema = schema.Schema{
-		MarkdownDescription: "This Ephemeral Resource retrieves a unique API token and invalidates it on exit.",
+		MarkdownDescription: docCategoryAuthentication + "This Ephemeral Resource retrieves a unique API token and invalidates it on exit.",
 		Attributes:          authentication.ApiToken{}.EphemeralAttributes(),
 	}
 }
diff --git a/docs/ephemeral-resources/api_token.md b/docs/ephemeral-resources/api_token.md
index 0e6b6f62..b9b1ace1 100644
--- a/docs/ephemeral-resources/api_token.md
+++ b/docs/ephemeral-resources/api_token.md
@@ -1,15 +1,15 @@
 ---
 page_title: "apstra_api_token Ephemeral Resource - terraform-provider-apstra"
-subcategory: ""
+subcategory: "Authentication"
 description: |-
   This Ephemeral Resource retrieves a unique API token and invalidates it on exit.
 ---
 
 # apstra_api_token (Ephemeral Resource)
 
-
 This Ephemeral Resource retrieves a unique API token and invalidates it on exit.
 
+
 ## Example Usage
 
 ```terraform