🐛 fix(powershell): change error handling in Get-DiscussionId script

  - replace return with exit 1 for better error signaling when documentation category is not found

📝 docs(config): update configuration documentation with discussion IDs
  - add discussionId to config, config-wizard, schema, and processors documents
  - ensure consistency and traceability in documentation

✅ test(scripts): add new test scripts for categories and permissions
  - introduce test-categories.ps1 and test-github-permissions.ps1 as placeholders for future test implementations

Author: MrHinsh

.powershell/docs/Get-DiscussionId.ps1

@@ -529,7 +529,7 @@ function Find-OrCreateDiscussion {
         if (-not $docCategory) {
             Write-ErrorLog "Documentation category '$GitHubDiscussionCategory' not found"
             Write-InformationLog "Available categories: $($categories.name -join ', ')"
-            return $null
+            exit 1
         }
 
         # Generate documentation URL

docs/content/docs/config/_index.md

@@ -5,4 +5,7 @@ description: |
 short_title: Configuration
 weight: 50
 date: 2025-06-24T12:07:31Z
+discussionId: 2904
+
 ---
+

docs/content/docs/config/config-wizard/index.md

@@ -4,20 +4,20 @@ short_title: Config Wizard
 description: Build your Azure DevOps Migration Tools configuration with our interactive step-by-step wizard supporting three migration type architectures
 weight: 50
 date: 2025-06-26T12:00:00Z
-discussionId:
+discussionId: 2902
 aliases:
-  - /config-wizard/
-  - /wizard/
-  - /configure/
+- /config-wizard/
+- /wizard/
+- /configure/
 layout: config-wizard
 cascade:
-  - build:
-      list: never
-      render: never
-    target:
-      environment: production
----
+- build:
+    list: never
+    render: never
+  target:
+    environment: production
 
+---
 Use this interactive wizard to build your Azure DevOps Migration Tools configuration. The wizard supports three primary migration types:
 
 - **Work Items**: Standard work item migration with pre-configured TfsWorkItemEndpoint and TfsWorkItemMigrationProcessor

docs/content/docs/config/schema/index.md

@@ -1,12 +1,16 @@
 ---
-title: "JSON Schemas"
-description: "JSON Schema definitions for Azure DevOps Migration Tools configuration"
+title: JSON Schemas
+description: JSON Schema definitions for Azure DevOps Migration Tools configuration
 weight: 10
-outputs: ["html", "schema-catalog"]
+outputs:
+- html
+- schema-catalog
 aliases:
-  - /schema/
----
+- /schema/
+date: 2025-07-23T09:41:21Z
+discussionId: 2901
 
+---
 The Azure DevOps Migration Tools provide JSON Schema definitions for configuration validation and IDE support.
 
 ## Main Configuration Schema

docs/content/docs/reference/processors/tfs-workitemtype-validator-processor/index.md

@@ -4,13 +4,14 @@ description: Validates Work Item Types against a set of rules. Does not migrate
 dataFile: reference.processors.tfsworkitemtypevalidatorprocessor.yaml
 slug: tfs-workitem-type-validator-processor
 aliases:
-  - /docs/Reference/Processors/TfsWorkItemTypeValidatorProcessor
-  - /Reference/Processors/TfsWorkItemTypeValidatorProcessor
-  - /learn/azure-devops-migration-tools/Reference/Processors/TfsWorkItemTypeValidatorProcessor
-  - /learn/azure-devops-migration-tools/Reference/Processors/TfsWorkItemTypeValidatorProcessor/index.md
+- /docs/Reference/Processors/TfsWorkItemTypeValidatorProcessor
+- /Reference/Processors/TfsWorkItemTypeValidatorProcessor
+- /learn/azure-devops-migration-tools/Reference/Processors/TfsWorkItemTypeValidatorProcessor
+- /learn/azure-devops-migration-tools/Reference/Processors/TfsWorkItemTypeValidatorProcessor/index.md
 date: 2025-06-24T12:07:31Z
----
+discussionId: 2905
 
+---
 {{< class-description >}}
 
 ## Options

docs/content/docs/reference/tools/tfs-workitemtype-validator-tool/index.md

@@ -5,13 +5,14 @@ dataFile: reference.tools.tfsworkitemtypevalidatortool.yaml
 schemaFile: schema.tools.tfsworkitemtypevalidatortool.json
 slug: work-item-type-validator-tool
 aliases:
-  - /docs/Reference/Tools/WorkItemTypeValidatorTool
-  - /Reference/Tools/WorkItemTypeValidatorTool
-  - /learn/azure-devops-migration-tools/Reference/Tools/WorkItemTypeValidatorTool
-  - /learn/azure-devops-migration-tools/Reference/Tools/WorkItemTypeMappingTool/index.md
+- /docs/Reference/Tools/WorkItemTypeValidatorTool
+- /Reference/Tools/WorkItemTypeValidatorTool
+- /learn/azure-devops-migration-tools/Reference/Tools/WorkItemTypeValidatorTool
+- /learn/azure-devops-migration-tools/Reference/Tools/WorkItemTypeMappingTool/index.md
 date: 2025-06-24T12:07:31Z
----
+discussionId: 2903
 
+---
 {{< class-description >}}
 
 ## Options