Edits based on comments in PR 894

Agoric · Dec 18, 2023 · 79659b0 · 79659b0
1 parent 7d3ab1e
commit 79659b0
Showing 1 changed file with 14 additions and 2 deletions.
diff --git a/main/guides/getting-started/start-a-project.md b/main/guides/getting-started/start-a-project.md
@@ -160,8 +160,20 @@ cd demo
 yarn install
 ```
 
-
-## Starting the Network
+<details>
+ <summary>Troubleshooting yarn install</summary>
+
+ If you run into errors during `yarn install`, 
+ check that you are on a [supported platform](#platform-requirements) and 
+ not native Windows. 
+
+ Then make sure you have the relevant developer tools installed. For example, on Debian or Ubuntu Linux, run `sudo apt get install build-essential`. 
+ On MacOS, be install 
+ [Xcode](https://apps.apple.com/us/app/xcode/id497799835). 
+
+  </details>
+
+## Starting a Local Agoric Blockchain
 Now go ahead and start the network using the `yarn start` command.
 
 ```sh