From 122efb4a8e58cc7c9dd098bb0fb6c267fc2f713a Mon Sep 17 00:00:00 2001
From: harryswift01 <harry.swift@stfc.ac.uk>
Date: Wed, 21 Jan 2026 09:56:21 +0000
Subject: [PATCH 1/5] update `.github/ISSUE_TEMPLATE/bug_report.md` with full
 template

---
 .github/ISSUE_TEMPLATE/bug_report.md | 82 +++++++++++++++++++---------
 1 file changed, 57 insertions(+), 25 deletions(-)

diff --git a/.github/ISSUE_TEMPLATE/bug_report.md b/.github/ISSUE_TEMPLATE/bug_report.md
index dd84ea7..2f44416 100644
--- a/.github/ISSUE_TEMPLATE/bug_report.md
+++ b/.github/ISSUE_TEMPLATE/bug_report.md
@@ -1,38 +1,70 @@
 ---
 name: Bug report
 about: Create a report to help us improve
-title: ''
-labels: ''
+title: '[Bug]: '
+labels: bug
 assignees: ''
 
 ---
 
-**Describe the bug**
-A clear and concise description of what the bug is.
+# Bug Report
+<!-- A clear and concise description of the issue. -->
 
-**To Reproduce**
-Steps to reproduce the behavior:
-1. Go to '...'
-2. Click on '....'
-3. Scroll down to '....'
-4. See error
+---
+
+## To Reproduce
+<!-- Provide the YAML configuration and the exact CLI command that reproduces the issue. -->
+
+### YAML configuration
+<!-- Paste the YAML file or the smallest excerpt that reproduces the issue.
+Remove unrelated fields to make it minimal. -->
+```yaml
+# Paste the YAML snippet here
+```
+
+### CLI command used
+<!-- Write the exact command used, for example:   -->
+```bash
+# Paste the CLI command here
+```
+
+### Actual output
+<!-- Paste the output, logs, or error messages here -->
+```bash
+# Paste the output, logs, or error messages here
+```
+
+### Expected output
+<!-- Describe what you expected to see instead -->
+
+---
 
-**Expected behavior**
-A clear and concise description of what you expected to happen.
+## Environment and Versions
 
-**Screenshots**
-If applicable, add screenshots to help explain your problem.
+- Operating System:
+- Package Version:
+- Python Version:
+- Package list:
+  - If using conda, run: `conda list > packages.txt` and paste the contents here.
 
-**Desktop (please complete the following information):**
- - OS: [e.g. iOS]
- - Browser [e.g. chrome, safari]
- - Version [e.g. 22]
+    ``` bash
+    # Paste packages.txt here
+    ```
+
+  - If using venv/pip, run: `pip list > packages.txt` and paste the contents here.
+
+    ``` bash
+    # Paste packages.txt here
+    ```
+
+---
+
+## Screenshots or Logs
+
+<!-- Attach any relevant screenshots, logs, or stack traces. -->
+
+---
 
-**Smartphone (please complete the following information):**
- - Device: [e.g. iPhone6]
- - OS: [e.g. iOS8.1]
- - Browser [e.g. stock browser, safari]
- - Version [e.g. 22]
+## Additional Context
 
-**Additional context**
-Add any other context about the problem here.
+<!-- Include anything else that might help reproduce or understand the bug, such as changes from a previously working version. -->

From 3bea45612d2b840f5f25a01331ba6981751252b0 Mon Sep 17 00:00:00 2001
From: harryswift01 <harry.swift@stfc.ac.uk>
Date: Wed, 21 Jan 2026 09:57:39 +0000
Subject: [PATCH 2/5] update `.github/ISSUE_TEMPLATE/feature_request.md` with
 full template

---
 .github/ISSUE_TEMPLATE/feature_request.md | 32 ++++++++++++++---------
 1 file changed, 20 insertions(+), 12 deletions(-)

diff --git a/.github/ISSUE_TEMPLATE/feature_request.md b/.github/ISSUE_TEMPLATE/feature_request.md
index bbcbbe7..1ea16e2 100644
--- a/.github/ISSUE_TEMPLATE/feature_request.md
+++ b/.github/ISSUE_TEMPLATE/feature_request.md
@@ -1,20 +1,28 @@
 ---
 name: Feature request
-about: Suggest an idea for this project
-title: ''
-labels: ''
+about: Suggest an idea
+title: '[Feature]: '
+labels: 'enhancement'
 assignees: ''
-
 ---
 
-**Is your feature request related to a problem? Please describe.**
-A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]
+# Feature Request
+
+## Problem / Motivation
+<!-- Describe the problem you want to solve or the motivation for this feature. -->
+
+## Proposed Solution
+<!-- Describe the feature you would like to see implemented. Include examples if applicable. -->
 
-**Describe the solution you'd like**
-A clear and concise description of what you want to happen.
+## Alternatives Considered
+- <!-- Alternative 1 -->
+- <!-- Alternative 2 -->
 
-**Describe alternatives you've considered**
-A clear and concise description of any alternative solutions or features you've considered.
+## Expected Impact
+<!-- How this feature would affect the codebase or workflow -->
+- <!-- Impact 1 -->
+- <!-- Impact 2 -->
 
-**Additional context**
-Add any other context or screenshots about the feature request here.
+## Additional Context
+<!-- Add any other context, screenshots, or references for the feature request here. -->
+- <!-- Further context -->

From 538ac9350bc057b2fd34e2a7157bcae1d84d4f5d Mon Sep 17 00:00:00 2001
From: harryswift01 <harry.swift@stfc.ac.uk>
Date: Wed, 21 Jan 2026 09:58:54 +0000
Subject: [PATCH 3/5] add `.github/ISSUE_TEMPLATE/documentation.md` with full
 template

---
 .github/ISSUE_TEMPLATE/custom.md        | 10 ----------
 .github/ISSUE_TEMPLATE/documentation.md | 19 +++++++++++++++++++
 2 files changed, 19 insertions(+), 10 deletions(-)
 delete mode 100644 .github/ISSUE_TEMPLATE/custom.md
 create mode 100644 .github/ISSUE_TEMPLATE/documentation.md

diff --git a/.github/ISSUE_TEMPLATE/custom.md b/.github/ISSUE_TEMPLATE/custom.md
deleted file mode 100644
index 48d5f81..0000000
--- a/.github/ISSUE_TEMPLATE/custom.md
+++ /dev/null
@@ -1,10 +0,0 @@
----
-name: Custom issue template
-about: Describe this issue template's purpose here.
-title: ''
-labels: ''
-assignees: ''
-
----
-
-
diff --git a/.github/ISSUE_TEMPLATE/documentation.md b/.github/ISSUE_TEMPLATE/documentation.md
new file mode 100644
index 0000000..9d0de48
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/documentation.md
@@ -0,0 +1,19 @@
+---
+name: Documentation
+about: Suggest updates or additions to documentation
+title: "[Docs]: "
+labels: documentation
+assignees: ''
+---
+
+### Documentation Update
+<!-- What part of the documentation needs to be updated or added? -->
+
+### Why Is This Needed?
+<!-- Explain the importance of this update. -->
+
+### Suggested Changes
+<!-- Provide a detailed description of the changes. -->
+
+### Additional Context
+<!-- Include any related resources. -->

From fab496d2d020ca3a3e5ae26e5eb8642b60ecb8ff Mon Sep 17 00:00:00 2001
From: harryswift01 <harry.swift@stfc.ac.uk>
Date: Wed, 21 Jan 2026 09:59:53 +0000
Subject: [PATCH 4/5] add `.github/ISSUE_TEMPLATE/general.md` with full
 template

---
 .github/ISSUE_TEMPLATE/general_report.md | 13 +++++++++++++
 1 file changed, 13 insertions(+)
 create mode 100644 .github/ISSUE_TEMPLATE/general_report.md

diff --git a/.github/ISSUE_TEMPLATE/general_report.md b/.github/ISSUE_TEMPLATE/general_report.md
new file mode 100644
index 0000000..611e7c0
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/general_report.md
@@ -0,0 +1,13 @@
+---
+name: General Report
+about: Provide general feedback or inquiries
+title: "[General]: "
+labels: general
+assignees: ''
+---
+
+### Feedback or Inquiry
+<!-- Provide your feedback or inquiry. -->
+
+### Additional Information
+<!-- Add any other relevant details here. -->

From 28758a87dcc38703944179fccbf157e90fc518c5 Mon Sep 17 00:00:00 2001
From: harryswift01 <harry.swift@stfc.ac.uk>
Date: Wed, 21 Jan 2026 10:01:20 +0000
Subject: [PATCH 5/5] add `.github/ISSUE_TEMPLATE/config.yml` for GitHub issue
 configuration

---
 .github/ISSUE_TEMPLATE/config.yml | 22 ++++++++++++++++++++++
 1 file changed, 22 insertions(+)
 create mode 100644 .github/ISSUE_TEMPLATE/config.yml

diff --git a/.github/ISSUE_TEMPLATE/config.yml b/.github/ISSUE_TEMPLATE/config.yml
new file mode 100644
index 0000000..0fa7423
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/config.yml
@@ -0,0 +1,22 @@
+blank_issues_enabled: false
+issue_templates:
+  - name: "Bug Report"
+    description: "Report a bug."
+    title: "[Bug]: "
+    labels: ["bug"]
+    body: "./ISSUE_TEMPLATE/bug_report.md"
+  - name: "Feature Request"
+    description: "Propose a new feature or improvement."
+    title: "[Feature]: "
+    labels: ["enhancement"]
+    body: "./ISSUE_TEMPLATE/feature_request.md"
+  - name: "Documentation"
+    description: "Suggest updates or additions to the documentation."
+    title: "[Docs]: "
+    labels: ["documentation"]
+    body: "./ISSUE_TEMPLATE/documentation.md"
+  - name: "General Report"
+    description: "Provide general feedback or inquiries."
+    title: "[General]: "
+    labels: ["general"]
+    body: "./ISSUE_TEMPLATE/general_report.md"