summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--.github/ISSUE_TEMPLATE/bug_report.yaml11
1 files changed, 11 insertions, 0 deletions
diff --git a/.github/ISSUE_TEMPLATE/bug_report.yaml b/.github/ISSUE_TEMPLATE/bug_report.yaml
index 30d846c18..18df90828 100644
--- 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