try to encourage more discussions, less bugs

Change-Id: If7e07fffeea6d32af4f2e819111315783e902b8e

diff --git a/.github/ISSUE_TEMPLATE/bug_report.yaml b/.github/ISSUE_TEMPLATE/bug_report.yaml
index 30d846c181ef2113a772f13e2410312e77cb5d1a..18df908288c585632385ce08caeb1e354df548d4 100644 (file)
--- a/.github/ISSUE_TEMPLATE/bug_report.yaml
+++ b/.github/ISSUE_TEMPLATE/bug_report.yaml
@@ -8,6 +8,17 @@ body:
   - type: markdown
     attributes:
       value: "
+
+**FOR NEW USERS:** the **VAST MAJORITY** of bugs reported are in fact
+**USAGE QUESTIONS** for APIs that can take some practice to familiarize with,
+and which are also tailored towards high quality relational designs that
+beginners are sometimes less familiar with.
+
+Please start a new
+[discussion](https://github.com/sqlalchemy/sqlalchemy/discussions/new?category=Usage-Questions) so that we can
+help with your issue.   If this is the first time you're using
+SQLAlchemy, there is an approximately **90% chance your issue is not a bug**, trust us!
+
 **GUIDELINES FOR REPORTING BUGS**
 
 If you are new to SQLAlchemy bug reports, please review our many examples