diff --git a/.github/issue_template.md b/.github/issue_template.md
index 4f0426c1..4a4542a5 100644
--- a/.github/issue_template.md
+++ b/.github/issue_template.md
@@ -1,6 +1,12 @@
 <!--- Provide a general summary of the issue in the Title above -->
 <!--- https://guides.github.com/features/mastering-markdown/#examples -->
 
+<!--- when including netdisco config snippets, whitespace matters since it's a yaml file -->
+<!--- for github issues it really helps if you include the relevant config parts in a codeblock (code fencing) -->
+<!--- see the "code" subject on https://guides.github.com/features/mastering-markdown/ for that) -->
+<!--- this should preserve spaces in the issue tracker and make troubleshooting quicker -->
+
+
 ## Expected Behavior
 <!--- If you're describing a bug, tell us what should happen -->
 <!--- If you're suggesting a change/improvement, tell us how it should work -->