Revision cac43ed4
| .github/ISSUE_TEMPLATE.md | ||
|---|---|---|
| 1 | 
    Thank you for opening an issue on an Adafruit Arduino library repository. To  | 
|
| 2 | 
    improve the speed of resolution please review the following guidelines and  | 
|
| 3 | 
    common troubleshooting steps below before creating the issue:  | 
|
| 4 | 
     | 
|
| 5 | 
    - **Do not use GitHub issues for troubleshooting projects and issues.** Instead use  | 
|
| 6 | 
    the forums at http://forums.adafruit.com to ask questions and troubleshoot why  | 
|
| 7 | 
    something isn't working as expected. In many cases the problem is a common issue  | 
|
| 8 | 
    that you will more quickly receive help from the forum community. GitHub issues  | 
|
| 9 | 
    are meant for known defects in the code. If you don't know if there is a defect  | 
|
| 10 | 
    in the code then start with troubleshooting on the forum first.  | 
|
| 11 | 
     | 
|
| 12 | 
    - **If following a tutorial or guide be sure you didn't miss a step.** Carefully  | 
|
| 13 | 
    check all of the steps and commands to run have been followed. Consult the  | 
|
| 14 | 
    forum if you're unsure or have questions about steps in a guide/tutorial.  | 
|
| 15 | 
     | 
|
| 16 | 
    - **For Arduino projects check these very common issues to ensure they don't apply**:  | 
|
| 17 | 
     | 
|
| 18 | 
    - For uploading sketches or communicating with the board make sure you're using  | 
|
| 19 | 
    a **USB data cable** and **not** a **USB charge-only cable**. It is sometimes  | 
|
| 20 | 
    very hard to tell the difference between a data and charge cable! Try using the  | 
|
| 21 | 
    cable with other devices or swapping to another cable to confirm it is not  | 
|
| 22 | 
    the problem.  | 
|
| 23 | 
     | 
|
| 24 | 
    - **Be sure you are supplying adequate power to the board.** Check the specs of  | 
|
| 25 | 
    your board and plug in an external power supply. In many cases just  | 
|
| 26 | 
    plugging a board into your computer is not enough to power it and other  | 
|
| 27 | 
    peripherals.  | 
|
| 28 | 
     | 
|
| 29 | 
    - **Double check all soldering joints and connections.** Flakey connections  | 
|
| 30 | 
    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.  | 
|
| 31 | 
     | 
|
| 32 | 
    - **Ensure you are using an official Arduino or Adafruit board.** We can't  | 
|
| 33 | 
    guarantee a clone board will have the same functionality and work as expected  | 
|
| 34 | 
    with this code and don't support them.  | 
|
| 35 | 
     | 
|
| 36 | 
    If you're sure this issue is a defect in the code and checked the steps above  | 
|
| 37 | 
    please fill in the following fields to provide enough troubleshooting information.  | 
|
| 38 | 
    You may delete the guideline and text above to just leave the following details:  | 
|
| 39 | 
     | 
|
| 40 | 
    - Arduino board: **INSERT ARDUINO BOARD NAME/TYPE HERE**  | 
|
| 41 | 
     | 
|
| 42 | 
    - Arduino IDE version (found in Arduino -> About Arduino menu): **INSERT ARDUINO  | 
|
| 43 | 
    VERSION HERE**  | 
|
| 44 | 
     | 
|
| 45 | 
    - List the steps to reproduce the problem below (if possible attach a sketch or  | 
|
| 46 | 
    copy the sketch code in too): **LIST REPRO STEPS BELOW**  | 
|
Also available in: Unified diff