From 2e9ab68abdeafd0986017c891c0b8e28b15ddef3 Mon Sep 17 00:00:00 2001 From: Hugo Bernier Date: Sat, 12 Mar 2022 14:40:20 -0500 Subject: [PATCH] Updated Troubleshooting issues with samples (markdown) --- Troubleshooting-issues-with-samples.md | 18 +++++++++++++++++- 1 file changed, 17 insertions(+), 1 deletion(-) diff --git a/Troubleshooting-issues-with-samples.md b/Troubleshooting-issues-with-samples.md index 5383179..7345b6c 100644 --- a/Troubleshooting-issues-with-samples.md +++ b/Troubleshooting-issues-with-samples.md @@ -1 +1,17 @@ -TO BE COMPLETED \ No newline at end of file +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. \ No newline at end of file