Improve GitHub issue templates; questions should be discussions, not

issues.

Author: anthony-tuininga

.github/ISSUE_TEMPLATE/announcements.md

@@ -7,4 +7,10 @@ assignees: ''
 
 ---
 
-<!-- Let us know if you are speaking at a conference on python-oracledb, or have a new package or app that uses python-oracledb, or something similarly exciting. -->
+<!--
+
+Please start a discussion at https://github.com/oracle/python-oracledb/discussions instead of creating an Issue.
+
+Let us know if you are speaking at a conference on python-oracledb, or have a new package or app that uses python-oracledb, or something similarly exciting.
+
+-->

.github/ISSUE_TEMPLATE/bug_report.md

@@ -54,7 +54,15 @@ Use a gist for long screen output and logs: see https://gist.github.com/
 
 -->
 
-4. Include a runnable Python script that shows the problem.
+4. Does your application call init_oracle_client()?
+
+<!--
+
+This tells us whether you are using the python-oracledb Thin or Thick mode.
+
+-->
+
+5. Include a runnable Python script that shows the problem.
 
 <!--
 
@@ -63,7 +71,7 @@ Include all SQL needed to create the database schema.
 Format code by using three backticks on a line before and after code snippets, for example:
 
 ```
-import python-oracledb
+import oracledb
 ```
 
 -->

.github/ISSUE_TEMPLATE/enhancement-requests.md

@@ -11,7 +11,7 @@ assignees: ''
 
 Thank you for using python-oracledb.
 
-Review existing enhancement requests: https://github.com/oracle/python-python-oracledb/labels/enhancement
+Review existing enhancement requests: https://github.com/oracle/python-oracledb/labels/enhancement
 
 Please answer these questions so we can help you.
 

.github/ISSUE_TEMPLATE/general-questions-and-runtime-problems.md

@@ -9,56 +9,8 @@ assignees: ''
 
 <!--
 
-Thank you for using python-oracledb.
+Please start a discussion at https://github.com/oracle/python-oracledb/discussions instead of creating an Issue.
 
-Review the user manual: https://python-oracledb.readthedocs.io/en/latest/index.html
-
-Please answer these questions so we can help you.
-
-Use Markdown syntax, see https://docs.github.com/github/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax
-
-GitHub issues that are not updated for a month may be automatically closed.  Feel free to update them at any time.
-
--->
-
-1. What versions are you using?
-
-<!--
-
-Give your database version.
-
-Also run Python and show the output of:
-
-    import sys
-    import platform
-
-    print("platform.platform:", platform.platform())
-    print("sys.maxsize > 2**32:", sys.maxsize > 2**32)
-    print("platform.python_version:", platform.python_version())
-
-And:
-
-    import oracledb
-    print("oracledb.__version__:", oracledb.__version__)
-
--->
-
-2. Describe the problem
-
-<!-- Cut and paste text showing the command you ran.  No screenshots. -->
-
-3. Include a runnable Python script that shows the problem.
-
-<!--
-
-Include all SQL needed to create the database schema.
-
-Use a gist for long code: see https://gist.github.com/
-
-Format code by using three backticks on a line before and after code snippets, for example:
-
-```
-import python-oracledb
-```
+Give as much background information as possible: versions, runnable code, all SQL to create tables etc.
 
 -->

.github/ISSUE_TEMPLATE/installation-questions.md

@@ -9,49 +9,14 @@ assignees: ''
 
 <!--
 
-Thank you for using python-oracledb.
+Please start a discussion at https://github.com/oracle/python-oracledb/discussions instead of creating an Issue.
 
-Do these before creating a new issue:
+Give as much background information as possible: versions, runnable code, all SQL to create tables etc.
 
-    Review and follow the Installation Instructions: https://python-oracledb.readthedocs.io/en/latest/user_guide/installation.html
+But first Review:
 
-    Review the troubleshooting tips: https://python-oracledb.readthedocs.io/en/latest/user_guide/installation.html#troubleshooting
+    - the Installation Instructions: https://python-oracledb.readthedocs.io/en/latest/user_guide/installation.html
 
-    Review the user manual: https://python-oracledb.readthedocs.io/en/latest/index.html
-
-If you have a `DPI-1047`, `DPI-1050` or `DPI-1072` error, re-review the links above.
-
-Google any errors.
-
-Then please answer these questions so we can help you.
-
-GitHub issues that are not updated for a month may be automatically closed.  Feel free to update them at any time.
-
--->
-
-1. What versions are you using?
-
-<!--
-
-Give your database version.
-
-Also run Python and show the output of:
-
-    import sys
-    import platform
-
-    print("platform.platform:", platform.platform())
-    print("sys.maxsize > 2**32:", sys.maxsize > 2**32)
-    print("platform.python_version:", platform.python_version())
+    - the troubleshooting tips: https://python-oracledb.readthedocs.io/en/latest/user_guide/installation.html#troubleshooting
 
 -->
-
-2. Describe the problem
-
-<!-- Cut and paste text showing the command you ran.  No screenshots. -->
-
-3. Show the directory listing where your Oracle Client libraries are installed (e.g. the Instant Client directory).  Is it 64-bit or 32-bit?
-
-4. Show what the `PATH` environment variable (on Windows) or `LD_LIBRARY_PATH` (on Linux) is set to?
-
-5. Show any Oracle environment variables set (e.g. ORACLE_HOME, ORACLE_BASE).

.github/SUPPORT.md

@@ -26,7 +26,4 @@ is [here](http://python-oracledb.readthedocs.io/en/latest/)
 
 ## Got a python-oracledb question?
 
-Ask at [GitHub](https://github.com/oracle/python-python-oracledb/issues)
-
-When opening a new issue, fill in the template that will be shown.
-Include enough information for people to understand your problem.
+Start a [Discussion](https://github.com/oracle/python-oracledb/discussions) on GitHub.