diff --git a/docs/running-locally.md b/docs/running-locally.md
index 128ab18c7df6..4d3af11dac7a 100644
--- a/docs/running-locally.md
+++ b/docs/running-locally.md
@@ -44,6 +44,10 @@ Either:
 
 At this point you’ll have everything you need to use the CLI and UI.
 
+## Troubleshooting Notes
+
+If you get a similar error when running one of the make pre-commit tests `make: *** [pkg/apiclient/clusterworkflowtemplate/cluster-workflow-template.swagger.json] Error 1`, ensure you are working within your $GOPATH (YOUR-GOPATH/src/github.com/argoproj/argo-workflows).
+
 ## Clean
 
 To clean-up everything: