diff --git a/docs/rust_analyzer.md b/docs/rust_analyzer.md
index 8678da8629..e2429ac647 100644
--- a/docs/rust_analyzer.md
+++ b/docs/rust_analyzer.md
@@ -51,7 +51,7 @@ A list of `rust_analyzer` compatible targets can be found by usign the following
 bazel query 'kind("rust_*library|rust_binary", //...:all)'
 ```
 
-Note that visibility rules apply.
+Note: __All `rust_*` targets provided to the root rust_analyzer must have `//visibility:public`.__
 
 Run `bazel run @rules_rust//tools/rust_analyzer:gen_rust_project` whenever
 dependencies change to regenerate the `rust-project.json` file. It should be
diff --git a/docs/rust_analyzer.vm b/docs/rust_analyzer.vm
index a3cf522555..d96b4f41a7 100644
--- a/docs/rust_analyzer.vm
+++ b/docs/rust_analyzer.vm
@@ -45,7 +45,7 @@ A list of `rust_analyzer` compatible targets can be found by usign the following
 bazel query 'kind("rust_*library|rust_binary", //...:all)'
 ```
 
-Note that visibility rules apply.
+Note: __All `rust_*` targets provided to the root rust_analyzer must have `//visibility:public`.__
 
 Run `bazel run @rules_rust//tools/rust_analyzer:gen_rust_project` whenever
 dependencies change to regenerate the `rust-project.json` file. It should be