Updated Troubleshooting issues with samples (markdown)

Troubleshooting-issues-with-samples.md

@@ -1 +1,17 @@
-TO BE COMPLETED
+If you run into issues using a sample, you should know that *every sample is tested and reviewed before it is approved*; while it may not work in your environment, or due to changes in some of the sample's dependencies, the sample worked when it was posted.
+
+This article should help you resolve the majority of issues, starting with the most likely cause to the most obscure.
+
+Once you have performed the steps in this article, you can proceed with creating an issue -- but make sure to read [how to create good issues](How-to-create-good-issues) first, because the people who support these samples are all volunteers, and we certainly want to be respectful of their time, *don't we*?
+
+```mermaid
+  graph TD;
+      A-->B;
+      A-->C;
+      B-->D;
+      C-->D;
+```
+## Most likely cause: Node.js incompatibility
+
+Every version of SPFx can be compatible with a different version of Node.js. If you run into an issue with `npm install`, `gulp serve`, `gulp build`, or any other `gulp` commands, 
+Please refer to the [SPFx Compatibility Matrix](https://docs.microsoft.com/en-us/sharepoint/dev/spfx/compatibility) to make sure that you're using a version of Node.js that is compatible with the version of SPFx the sample uses.