From ec55a934054bba85826ee0564fded89907f53dc5 Mon Sep 17 00:00:00 2001
From: Brooke Kuhlmann <brooke@alchemists.io>
Date: Fri, 8 Aug 2025 11:17:37 -0600
Subject: [PATCH] Updated GitHub issue and code review templates

Necessary to fix an issue with the issue templates since GitHub no longer respects the `.github/ISSUE_TEMPLATE.md` file so am now using the `ISSUE_TEMPLATE` folder with additional links to community and security information. Only a single issue template is being used to reduce the number of choices people have to make. The code view template was also updated to improve the descriptions.

Milestone: minor
---
 .github/ISSUE_TEMPLATE.md         |  8 --------
 .github/ISSUE_TEMPLATE/config.yml |  8 ++++++++
 .github/ISSUE_TEMPLATE/issue.md   | 18 ++++++++++++++++++
 .github/PULL_REQUEST_TEMPLATE.md  |  6 +++---
 4 files changed, 29 insertions(+), 11 deletions(-)
 delete mode 100644 .github/ISSUE_TEMPLATE.md
 create mode 100644 .github/ISSUE_TEMPLATE/config.yml
 create mode 100644 .github/ISSUE_TEMPLATE/issue.md

diff --git a/.github/ISSUE_TEMPLATE.md b/.github/ISSUE_TEMPLATE.md
deleted file mode 100644
index b614951..0000000
--- a/.github/ISSUE_TEMPLATE.md
+++ /dev/null
@@ -1,8 +0,0 @@
-## Why
-<!-- Required. Describe, briefly, why this issue is important. -->
-
-## How
-<!-- Optional. List exact steps (numbered) to implement or reproduce behavior. Screen shots/casts are welcome. -->
-
-## Notes
-<!-- Optional. Provide additional details (i.e operating system, software version(s), stack dump, etc.) -->
diff --git a/.github/ISSUE_TEMPLATE/config.yml b/.github/ISSUE_TEMPLATE/config.yml
new file mode 100644
index 0000000..29a903d
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/config.yml
@@ -0,0 +1,8 @@
+blank_issues_enabled: false
+contact_links:
+  - name: Community
+    url: https://alchemists.io/community
+    about: Please ask questions or discuss specifics here.
+  - name: Security
+    url: https://alchemists.io/policies/security
+    about: Please report security vulnerabilities here.
diff --git a/.github/ISSUE_TEMPLATE/issue.md b/.github/ISSUE_TEMPLATE/issue.md
new file mode 100644
index 0000000..61adc6e
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/issue.md
@@ -0,0 +1,18 @@
+---
+name: Issue
+title: "Add|Update|Fix|Remove|Refactor "
+about: Report an issue. Please use only one of the subject prefixes.
+---
+
+<!--
+Please focus on well written issues. Context: https://alchemists.io/articles/software_issues.
+-->
+
+## Why
+<!-- Required. Describe, briefly, why this issue is important. -->
+
+## How
+<!-- Optional. List exact steps to implement or reproduce behavior. Screen shots/casts are welcome! -->
+
+## Notes
+<!-- Optional. Provide additional details like operating system, software version(s), stack dump, logs, or anything else that would be helpful. -->
diff --git a/.github/PULL_REQUEST_TEMPLATE.md b/.github/PULL_REQUEST_TEMPLATE.md
index 5bb52a2..1b93c92 100644
--- a/.github/PULL_REQUEST_TEMPLATE.md
+++ b/.github/PULL_REQUEST_TEMPLATE.md
@@ -1,8 +1,8 @@
 ## Overview
-<!-- Required. Why is this important/necessary and what is the overarching architecture. -->
+<!-- Required. Describe, briefly, why this is necessary and what the overarching architecture is. -->
 
 ## Screenshots/Screencasts
-<!-- Optional. Provide supporting image/video. -->
+<!-- Optional. Provide supporting screen shots/casts. -->
 
 ## Details
-<!-- Optional. List the key features/highlights as bullet points. -->
+<!-- Optional. As bullet points, list related issue(s); major highlights; team callouts; and/or other information that is helpful. -->