honeymoose
/
sp-dev-fx-webparts
mirror of https://github.com/pnp/sp-dev-fx-webparts.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Removed mermaid

Hugo Bernier 2022-03-27 02:54:54 -04:00
parent 8ff2b2e0c5
commit c29d73b8f7
3 changed files with 1281 additions and 18 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

22
Troubleshooting-issues-with-samples.md

@ -4,7 +4,7 @@ This article should help you resolve the majority of issues, starting with the m
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*?
Items marked with a :link: can be found in the [useful links](#useful-links) section.
Items marked with a :link: can be found on this page.
![Troubleshooting](./assets/troubleshooting1.svg)
@ -12,23 +12,9 @@ Items marked with a :link: can be found in the [useful links](#useful-links) sec
Please note that warnings will rarely prevent the solution from working; We only worry about errors.
```mermaid
graph TD
A([Run npm install])
A --> B{Errors?}
B --> |No| Z([Try gulp build])
B --> |Yes| C{Are you in root of project?} --> |No| D["Change directory to root of project #128279;"] --> |Retry|A
C --> |Yes| E{Running on Windows?}
E --> |Yes| F{Path too long?} --> |Yes| H[Move project to shorter path] --> |Retry|A
E --> |No| K["Run spfx doctor #128279;"]
K --> J{Any reported issues?} --> |Yes| L[Fix compatibility issues] --> |Retry|A
K --> |No| M{Did you change <br/> versions of nodejs<br/> after downloading sample?} --> |Yes| N[Run npm rebuild node-sass] --> |Retry|A
M --> |No| O(["Before you open a new issue #128279;"])
click K "https://github.com/pnp/sp-dev-fx-webparts/wiki/Troubleshooting-issues-with-samples#run-spfx-doctor"
click D "https://github.com/pnp/sp-dev-fx-webparts/wiki/Troubleshooting-issues-with-samples#change-directory-to-root-of-project"
click O "https://github.com/pnp/sp-dev-fx-webparts/wiki/Before-you-open-an-issue"
style A fill:#2da44e,color:#fff,stroke:#1b1f2426
```
Items marked with a :link: can be found on this page.
![Troubleshooting npm install](./assets/troubleshooting2.svg)
### Change directory to root of project

1262
assets/troubleshooting2.svg Normal file

File diff suppressed because it is too large Load Diff
Side by Side

After

Width:  |  Height:  |  Size: 57 KiB

15
troubleshooting2.mmd Normal file

@ -0,0 +1,15 @@
graph TD
A([Run npm install])
A --> B{Errors?}
B --> |No| Z([Try gulp build])
B --> |Yes| C{Are you in root of project?} --> |No| D["Change directory to root of project #128279;"] --> |Retry|A
C --> |Yes| E{Running on Windows?}
E --> |Yes| F{Path too long?} --> |Yes| H[Move project to shorter path] --> |Retry|A
E --> |No| K["Run spfx doctor #128279;"]
K --> J{Any reported issues?} --> |Yes| L[Fix compatibility issues] --> |Retry|A
K --> |No| M{Did you change <br/> versions of nodejs<br/> after downloading sample?} --> |Yes| N[Run npm rebuild node-sass] --> |Retry|A
M --> |No| O(["Before you open a new issue #128279;"])
click K "https://github.com/pnp/sp-dev-fx-webparts/wiki/Troubleshooting-issues-with-samples#run-spfx-doctor"
click D "https://github.com/pnp/sp-dev-fx-webparts/wiki/Troubleshooting-issues-with-samples#change-directory-to-root-of-project"
click O "https://github.com/pnp/sp-dev-fx-webparts/wiki/Before-you-open-an-issue"
style A fill:#2da44e,color:#fff,stroke:#1b1f2426