From cb9df813eced9453a68fbb0ba1c7946bc367bf20 Mon Sep 17 00:00:00 2001
From: Mike Bayer <mike_mp@zzzcomputing.com>
Date: Tue, 7 Feb 2023 13:29:02 -0500
Subject: [PATCH] another template edit

Change-Id: I611eefbb166ab10d05011f39df2b4531a1f59968
---
 .github/ISSUE_TEMPLATE/bug_report.yaml | 32 ++++++++++++++++++++++----
 1 file changed, 27 insertions(+), 5 deletions(-)

diff --git a/.github/ISSUE_TEMPLATE/bug_report.yaml b/.github/ISSUE_TEMPLATE/bug_report.yaml
index 71c9993fe6..5284d3af76 100644
--- a/.github/ISSUE_TEMPLATE/bug_report.yaml
+++ b/.github/ISSUE_TEMPLATE/bug_report.yaml
@@ -12,7 +12,8 @@ body:
 **If you are writing new SQLAlchemy code and are observing a behavior that you did not expect,
 or if you are new to SQLAlchemy overall, please open a
 [discussion](https://github.com/sqlalchemy/sqlalchemy/discussions/new?category=Usage-Questions)
-instead of an issue report.  The vast majority of new issues are converted to discussions**
+instead of an issue report.  The VAST MAJORITY of issues are converted to discussions
+as they are not bugs.**
 
 [START A NEW USAGE QUESTIONS DISCUSSION HERE](https://github.com/sqlalchemy/sqlalchemy/discussions/new?category=Usage-Questions)
 
@@ -89,15 +90,28 @@ If the message is a warning, run your program with the ``-Werror`` flag:   ``pyt
       required: true
 
   - type: input
-    id: sqlaversion
+    id: relevant_documentation
+    attributes:
+      label: Link from https://docs.sqlalchemy.org which documents the behavior that is expected
+      description:  "
+Please make sure the behavior you are seeing is definitely in contradiction
+to what's documented as the correct behavior.  If unsure, open a
+[discussion](https://github.com/sqlalchemy/sqlalchemy/discussions/new?category=Usage-Questions)
+instead.
+"
+    validations:
+      required: true
+
+  - type: input
+    id: sqlalchemy_version
     attributes:
       label: SQLAlchemy Version in Use
-      description: the full version of SQLAlchemy in use
+      description: e.g. 1.4.42, 2.0.2, etc
     validations:
       required: true
 
   - type: input
-    id: dbapiversion
+    id: dbapi_version
     attributes:
       label: DBAPI Version
       description: the DBAPI (database driver) version
@@ -105,13 +119,21 @@ If the message is a warning, run your program with the ``-Werror`` flag:   ``pyt
       required: true
 
   - type: input
-    id: database
+    id: database_version
     attributes:
       label: Database Vendor and Version
       description: e.g. SQLite, PostgreSQL 12, MariaDB 8
     validations:
       required: true
 
+  - type: input
+    id: python_version
+    attributes:
+      label: Python Version
+      description: assumes cpython unless otherwise stated, e.g. 3.10, 3.11, pypy
+    validations:
+      required: true
+
   - type: input
     id: os
     attributes:
-- 
2.47.3