cicd: attempt at documenting labels to choices

Author: 56kyle

.github/ISSUE_TEMPLATE/01_bug_report.yml

@@ -1,8 +1,38 @@
 name: '🐛 Bug Report'
 description: Report a bug with the template or generated projects
-labels: [bug]
+labels: [bug, needs-triage]
 title: '[Bug] '
 
+# Label Mapping Documentation for GitHub Actions:
+# 
+# Scope mapping (based on issue_scope field):
+# - "Template (generation, hooks, template scripts)" → scope:template
+# - "Generated Project (nox, dependencies, tooling)" → scope:generated
+#
+# Component mapping (based on issue_category field):
+# - "Template - Nox commands" → component:nox
+# - "Template - Post-generation hooks" → component:hooks
+# - "*Rust extension*" → rust
+# - "*CI/CD*" → component:ci
+# - "*Container/Docker*" → component:container
+# - "*Documentation*" → documentation (remove from primary)
+# - "*Testing*" → component:testing
+# - "*Security*" → component:security
+# - "*Dependency*" → dependencies (add as primary)
+#
+# Priority mapping (based on severity field):
+# - "Critical (blocks all usage)" → priority:critical
+# - "High (blocks major functionality)" → priority:high  
+# - "Medium (workaround available)" → priority:medium
+# - "Low (minor inconvenience)" → priority:low
+#
+# Environment mapping (when relevant):
+# - python_version: "3.9" → python:3.9, etc.
+# - os: "macOS*" → os:macos, "Linux*" → os:linux, "Windows*" → os:windows, "WSL*" → os:wsl
+#
+# Feature flags:
+# - rust_extension: "Yes" → rust
+
 body:
   - type: markdown
     attributes:

.github/ISSUE_TEMPLATE/02_feature_request.yml

@@ -1,8 +1,35 @@
 name: '✨ Feature Request'
 description: Suggest new features or improvements for the template or generated projects
-labels: [enhancement]
+labels: [enhancement, needs-triage]
 title: '[Feature] '
 
+# Label Mapping Documentation for GitHub Actions:
+#
+# Scope mapping (based on feature_scope field):
+# - "Template (cookiecutter options, generation process)" → scope:template
+# - "Generated Project (nox sessions, tooling, structure)" → scope:generated
+# - "Both" → scope:both
+#
+# Component mapping (based on feature_category field):
+# - "*nox*" → component:nox
+# - "*hooks*" → component:hooks
+# - "*Rust*" → rust
+# - "*CI/CD*" → component:ci
+# - "*Container*" → component:container
+# - "*Documentation*" → documentation (add as primary)
+# - "*Testing*" → component:testing
+# - "*Security*" → component:security
+# - "*Dependency*" → dependencies (add as primary)
+#
+# Priority mapping (based on priority field):
+# - "Critical" → priority:critical
+# - "Important" → priority:high
+# - "Nice to have" → priority:medium
+#
+# Feature flags:
+# - rust_impact: "Yes*" → rust
+# - breaking_change: "Yes - Requires migration" → breaking-change
+
 body:
   - type: markdown
     attributes:

.github/ISSUE_TEMPLATE/03_documentation.yml

@@ -1,8 +1,24 @@
 name: '📖 Documentation Issue'
 description: Report documentation issues or suggest improvements
-labels: [documentation]
+labels: [documentation, needs-triage]
 title: '[Docs] '
 
+# Label Mapping Documentation for GitHub Actions:
+#
+# Scope mapping (based on doc_scope field):
+# - "Template (this repository)" → scope:template
+# - "Generated Project (documentation templates)" → scope:generated
+# - "Both" → scope:both
+#
+# Priority mapping (based on priority field):
+# - "Critical - Incorrect information" → priority:critical
+# - "High - Blocks understanding" → priority:high
+# - "Medium - Affects usability" → priority:medium
+# - "Low - Minor improvement" → priority:low
+#
+# Feature flags:
+# - affects_rust: "Yes*" → rust
+
 body:
   - type: markdown
     attributes:

.github/ISSUE_TEMPLATE/04_dependency_update.yml

@@ -1,8 +1,25 @@
 name: '📦 Dependency Update'
 description: Suggest updates to dependencies, tools, or versions
-labels: [dependencies, maintenance]
+labels: [dependencies, needs-triage]
 title: '[Dependency] '
 
+# Label Mapping Documentation for GitHub Actions:
+#
+# Scope mapping (based on update_scope field):
+# - "Template only" → scope:template
+# - "Generated projects only" → scope:generated
+# - "Both template and generated projects" → scope:both
+#
+# Priority mapping (based on urgency field):
+# - "Critical - Security vulnerability" → priority:critical
+# - "High - Breaks functionality" → priority:high
+# - "Medium - Improvement needed" → priority:medium
+# - "Low - Nice to have" → priority:low
+#
+# Feature flags:
+# - affects_rust: "Yes*" → rust
+# - breaking_change: "Major - Significant changes required" → breaking-change
+
 body:
   - type: markdown
     attributes: