diff --git a/.bazelrc b/.bazelrc
index 1352248..2419bfc 100644
--- a/.bazelrc
+++ b/.bazelrc
@@ -1,6 +1,5 @@
-# Bazel settings that apply to this repository.
-# Take care to document any settings that you expect users to apply.
-# Settings that apply only to CI are in .github/workflows/ci.bazelrc
+# These Bazel settings are applied by default; settings that apply only to CI are in
+# .github/workflows/ci.bazelrc and are applied in .github/workflows/ci.yaml
 build --nolegacy_external_runfiles
 
 # Load any settings specific to the current user.
diff --git a/.github/workflows/ci.bazelrc b/.github/workflows/ci.bazelrc
index 967616a..8b718cc 100644
--- a/.github/workflows/ci.bazelrc
+++ b/.github/workflows/ci.bazelrc
@@ -4,4 +4,7 @@ build --announce_rc
 test --test_output=errors
 build --disk_cache=$HOME/.cache/bazel
 build --repository_cache=$HOME/.cache/bazel-repo
+
+# XDG_CACHE_HOME is where bazelisk -- if used -- will cache downloads; workflows use setup-bazelisk
+# which aliases 'bazel' to bazelisk.  We inject this into the test runner env like an action_env
 test --test_env=XDG_CACHE_HOME
diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml
index b85789f..3bab70b 100644
--- a/.github/workflows/release.yml
+++ b/.github/workflows/release.yml
@@ -1,5 +1,5 @@
 # Cut a release whenever a new tag is pushed to the repo.
-# You should use an annotated tag, like `git tag -a v1.2.3`
+# You should use an annotated tag, like `git tag -a 1.2.3`
 # and put the release notes into the commit message for the tag.
 name: Release