diff --git a/gopls/doc/user.md b/gopls/doc/user.md
index 93090e86b1..341a4d1f37 100644
--- a/gopls/doc/user.md
+++ b/gopls/doc/user.md
@@ -39,6 +39,19 @@ then run
 GO111MODULE=on go get golang.org/x/tools/gopls@latest
 ```
 
+### Unstable versions
+
+`go get` doesn't honor the `replace` directive in the `go.mod` of
+`gopls` when you are outside of the `gopls` module, so a simple `go get`
+with `@master` could fail.  To actually update your `gopls` to the
+latest **unstable** version, use:
+
+```sh
+$ go get golang.org/x/tools/gopls@master golang.org/x/tools@master
+```
+
+In general, you should use `@latest` instead, to prevent frequent
+breakages.
 
 ## Configurations