From 0b141adae28b4530c577c8a4594635d1d78546d8 Mon Sep 17 00:00:00 2001
From: "Hans J. Johnson" <hans-johnson@uiowa.edu>
Date: Tue, 15 Sep 2026 16:27:47 -0500
Subject: [PATCH] ENH: Add GitHub issue templates for bug reports and feature
 requests

Give reporters a structured form for build and packaging problems so
issues arrive with the platform, Python version, ITK version, and entry
point needed to reproduce them. Point general questions to ITK Discourse
and the ITKPythonPackage documentation.

Split out of the Python build system work in #302, which it does not
depend on; issue titles use the ITK commit prefixes this repository
enforces.

Co-Authored-By: Cavan Riley <127157889+CavRiley@users.noreply.github.com>
---
 .github/ISSUE_TEMPLATE/bug_report.md      | 37 +++++++++++++++++++++++
 .github/ISSUE_TEMPLATE/config.yml         |  8 +++++
 .github/ISSUE_TEMPLATE/feature_request.md | 23 ++++++++++++++
 3 files changed, 68 insertions(+)
 create mode 100644 .github/ISSUE_TEMPLATE/bug_report.md
 create mode 100644 .github/ISSUE_TEMPLATE/config.yml
 create mode 100644 .github/ISSUE_TEMPLATE/feature_request.md

diff --git a/.github/ISSUE_TEMPLATE/bug_report.md b/.github/ISSUE_TEMPLATE/bug_report.md
new file mode 100644
index 00000000..ede8b27f
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/bug_report.md
@@ -0,0 +1,37 @@
+---
+name: Bug report
+about: Something is broken in the build or packaging pipeline
+title: "BUG: "
+labels: bug
+assignees: ""
+---
+
+## Environment
+
+- **OS / Platform**: <!-- e.g. Ubuntu 22.04 x86_64, macOS 14 arm64, Windows Server 2022 -->
+- **Python version**: <!-- e.g. 3.11.9 -->
+- **ITK version / branch**: <!-- e.g. v5.4.0, or commit hash -->
+- **Script / entry point used**: <!-- e.g. scripts/dockcross-manylinux-download-cache-and-build-module-wheels.sh -->
+
+## Steps to Reproduce
+
+
+## Expected Behavior
+
+<!-- What should happen. -->
+
+## Actual Behavior
+
+<!-- What actually happens. Paste relevant log output below. -->
+
+<details>
+<summary>Log output</summary>
+
+```
+```
+
+</details>
+
+## Additional Context
+
+<!-- ITKPythonBuilds tag, Docker image tag, CMake options, etc. -->
diff --git a/.github/ISSUE_TEMPLATE/config.yml b/.github/ISSUE_TEMPLATE/config.yml
new file mode 100644
index 00000000..9b1b5746
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/config.yml
@@ -0,0 +1,8 @@
+blank_issues_enabled: true
+contact_links:
+  - name: ITK Discourse (questions & support)
+    url: https://discourse.itk.org
+    about: For build questions or general ITK support, please use the ITK Discourse forum.
+  - name: ITKPythonPackage documentation
+    url: https://itkpythonpackage.readthedocs.io
+    about: Check the docs before filing an issue.
diff --git a/.github/ISSUE_TEMPLATE/feature_request.md b/.github/ISSUE_TEMPLATE/feature_request.md
new file mode 100644
index 00000000..fbed4aeb
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/feature_request.md
@@ -0,0 +1,23 @@
+---
+name: Feature request
+about: Suggest a new capability or improvement to the build/packaging pipeline
+title: "ENH: "
+labels: enhancement
+assignees: ""
+---
+
+## Problem / Motivation
+
+<!-- What limitation or pain point does this address? -->
+
+## Proposed Solution
+
+<!-- Describe what you'd like to see added or changed. -->
+
+## Alternatives Considered
+
+<!-- Any other approaches you've thought about? -->
+
+## Additional Context
+
+<!-- Platform relevance, ITK module context, links, etc. -->