diff --git a/.bazelignore b/.bazelignore
index 432102539c..37fa09a7af 100644
--- a/.bazelignore
+++ b/.bazelignore
@@ -1,11 +1,2 @@
-# Docs
-docs/bazel-bin
-docs/bazel-docs
-docs/bazel-out
-docs/bazel-testlogs
-
-# Examples
-examples/bazel-bin
-examples/bazel-examples
-examples/bazel-out
-examples/bazel-testlogs
+docs
+examples
diff --git a/docs/flatten.md b/docs/flatten.md
index 55ac7da2ed..9ad0b8ba03 100644
--- a/docs/flatten.md
+++ b/docs/flatten.md
@@ -1,6 +1,5 @@
# Rust rules
-* [bazel_version](#bazel_version)
* [cargo_build_script](#cargo_build_script)
* [rust_benchmark](#rust_benchmark)
* [rust_binary](#rust_binary)
@@ -884,7 +883,8 @@ rust_toolchain_repository(name, iso_date, rustfmt_version, sha256s, toolchain_name_prefix, version)
-Composes a single workspace containing the toolchain components for compiling on a given platform to a series of target platforms.
+Composes a single workspace containing the toolchain components for compiling on a given platform to a series of target platforms.
+
A given instance of this rule should be accompanied by a rust_toolchain_repository_proxy invocation to declare its toolchains to Bazel; the indirection allows separating toolchain selection from toolchain fetching.
**ATTRIBUTES**
diff --git a/docs/rust_repositories.md b/docs/rust_repositories.md
index 94ab8a5c18..65e2f8c474 100644
--- a/docs/rust_repositories.md
+++ b/docs/rust_repositories.md
@@ -90,7 +90,8 @@ rust_toolchain_repository(name, iso_date, rustfmt_version, sha256s, toolchain_name_prefix, version)
-Composes a single workspace containing the toolchain components for compiling on a given platform to a series of target platforms.
+Composes a single workspace containing the toolchain components for compiling on a given platform to a series of target platforms.
+
A given instance of this rule should be accompanied by a rust_toolchain_repository_proxy invocation to declare its toolchains to Bazel; the indirection allows separating toolchain selection from toolchain fetching.
**ATTRIBUTES**
diff --git a/docs/rust_workspace.md b/docs/rust_workspace.md
index 2ce2b810d5..7ef4458813 100644
--- a/docs/rust_workspace.md
+++ b/docs/rust_workspace.md
@@ -1,6 +1,5 @@
# Rust rules
* [rust_workspace](#rust_workspace)
-* [bazel_version](#bazel_version)