diff --git a/ISSUE_TEMPLATE.md b/ISSUE_TEMPLATE.md
index 71dccaa2b..018d44d6f 100644
--- a/ISSUE_TEMPLATE.md
+++ b/ISSUE_TEMPLATE.md
@@ -1,31 +1,28 @@
-<!--- ** Issues are ONLY for new bugs & feature requests. ** -->
-<!--- ** For coding problems see: forum.processing.org/ ** -->
-<!--- ** Before posting, search Issues for duplicates!  ** --> 
+<!--- ** Issues are for new bugs & feature requests. ** -->
+<!--- ** Be sure to read the [troubleshooting page](https://github.com/processing/processing/wiki/Troubleshooting) first ** -->
+<!--- ** For coding problems visit https://forum.processing.org ** -->
+<!--- ** Before posting, please search Issues for duplicates  ** --> 
 
 ## Description
-<!--- Use a descriptive Issue Title. -->
+<!--- Use a title that describes what is happening. -->
 <!--- Give a description of the proposed change. -->
 
 ## Expected Behavior
-<!--- Bug? Tell us what should happen. -->
-<!--- Improvement? Tell us how it should work. -->
+<!--- Bug? Tell us what you were expecting. -->
+<!--- Improvement? Tell us how you’d like it to work. -->
 
 ## Current Behavior
-<!--- Bug? What happens that is unexpected? -->
-<!--- Improvement? Explain the difference from current behavior. -->
+<!--- Explain the difference from current behavior. -->
 
 ## Steps to Reproduce
 <!--- Provide an unambiguous set of steps to reproduce. -->
-<!--- Include code if relevant. -->
+<!--- Including code will make it more likely to be fixed. -->
 1.
 2.
 3.
 
-## Context
-<!--- How has this issue affected you? What are you trying to accomplish? -->
-
 ## Your Environment
-<!--- Include as many relevant details about your environment -->
+<!--- Include details about your environment -->
 * Processing version:
 * Operating System and OS version:
 * Other information: