summaryrefslogtreecommitdiff
path: root/Adafruit_Python_MCP3008/.github/ISSUE_TEMPLATE.md
diff options
context:
space:
mode:
Diffstat (limited to 'Adafruit_Python_MCP3008/.github/ISSUE_TEMPLATE.md')
-rw-r--r--Adafruit_Python_MCP3008/.github/ISSUE_TEMPLATE.md47
1 files changed, 47 insertions, 0 deletions
diff --git a/Adafruit_Python_MCP3008/.github/ISSUE_TEMPLATE.md b/Adafruit_Python_MCP3008/.github/ISSUE_TEMPLATE.md
new file mode 100644
index 0000000..6344b2f
--- /dev/null
+++ b/Adafruit_Python_MCP3008/.github/ISSUE_TEMPLATE.md
@@ -0,0 +1,47 @@
+Thank you for opening an issue on an Adafruit Python library repository. To
+improve the speed of resolution please review the following guidelines and
+common troubleshooting steps below before creating the issue:
+
+- **Do not use GitHub issues for troubleshooting projects and issues.** Instead use
+ the forums at http://forums.adafruit.com to ask questions and troubleshoot why
+ something isn't working as expected. In many cases the problem is a common issue
+ that you will more quickly receive help from the forum community. GitHub issues
+ are meant for known defects in the code. If you don't know if there is a defect
+ in the code then start with troubleshooting on the forum first.
+
+- **If following a tutorial or guide be sure you didn't miss a step.** Carefully
+ check all of the steps and commands to run have been followed. Consult the
+ forum if you're unsure or have questions about steps in a guide/tutorial.
+
+- **For Python/Raspberry Pi projects check these very common issues to ensure they don't apply**:
+
+ - If you are receiving an **ImportError: No module named...** error then a
+ library the code depends on is not installed. Check the tutorial/guide or
+ README to ensure you have installed the necessary libraries. Usually the
+ missing library can be installed with the `pip` tool, but check the tutorial/guide
+ for the exact command.
+
+ - **Be sure you are supplying adequate power to the board.** Check the specs of
+ your board and power in an external power supply. In many cases just
+ plugging a board into your computer is not enough to power it and other
+ peripherals.
+
+ - **Double check all soldering joints and connections.** Flakey connections
+ cause many mysterious problems. See the [guide to excellent soldering](https://learn.adafruit.com/adafruit-guide-excellent-soldering/tools) for examples of good solder joints.
+
+If you're sure this issue is a defect in the code and checked the steps above
+please fill in the following fields to provide enough troubleshooting information.
+You may delete the guideline and text above to just leave the following details:
+
+- Platform/operating system (i.e. Raspberry Pi with Raspbian operating system,
+ Windows 32-bit, Windows 64-bit, Mac OSX 64-bit, etc.): **INSERT PLATFORM/OPERATING
+ SYSTEM HERE**
+
+- Python version (run `python -version` or `python3 -version`): **INSERT PYTHON
+ VERSION HERE**
+
+- Error message you are receiving, including any Python exception traces: **INSERT
+ ERROR MESAGE/EXCEPTION TRACES HERE***
+
+- List the steps to reproduce the problem below (if possible attach code or commands
+ to run): **LIST REPRO STEPS BELOW**