diff --git a/docs/user/manual.adoc b/docs/user/manual.adoc
index bd924031e03..b23c7c35d5d 100644
--- a/docs/user/manual.adoc
+++ b/docs/user/manual.adoc
@@ -141,6 +141,9 @@ If you're not using Code, you can compile and install only the LSP server:
 $ cargo xtask install --server
 ----
 
+Make sure that `.cargo/bin` is in `$PATH` and precedes paths where `rust-analyzer` may also be installed.
+Specifically, `rustup` includes a proxy called `rust-analyzer`, which can cause problems if you're planning to use a source build or even a downloaded binary.
+
 === rust-analyzer Language Server Binary
 
 Other editors generally require the `rust-analyzer` binary to be in `$PATH`.