From a050cff50f0eeebe36de586b76c9ec584d4d86ec Mon Sep 17 00:00:00 2001
From: James Shubin <james@shubin.ca>
Date: Mon, 13 May 2019 07:10:36 -0400
Subject: [PATCH] docs: Add build issue to FAQ

Some new users might experience this if they setup their $GOPATH
incorrectly.
---
 docs/faq.md | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/docs/faq.md b/docs/faq.md
index 6702fc1f..97fe086b 100644
--- a/docs/faq.md
+++ b/docs/faq.md
@@ -215,6 +215,17 @@ requires a number of seconds as an argument.
 ./mgmt run lang examples/lang/hello0.mcl --converged-timeout=5
 ```
 
+### When I try to build `mgmt` I see: `no Go files in $GOPATH/src/github.com/purpleidea/mgmt/bindata`.
+
+Due to the arcane way that `golang` designed its `$GOPATH`, the main project
+directory must be inside your `$GOPATH`, and at the appropriate FQDN. This is:
+`$GOPATH/src/github.com/purpleidea/mgmt/`. If you have your project root outside
+of that directory, then you may get this error when you try to build it. In this
+case there is likely a `go get` version of the project at this location. Remove
+it and replace it with your git cloned directory. In my case, I like to work on
+things in `~/code/mgmt/`, so that path is a symlink that points to the long
+project directory.
+
 ### On startup `mgmt` hangs after: `etcd: server: starting...`.
 
 If you get an error message similar to: