diff --git a/docs/pip.md b/docs/pip.md
index 528abf737d..e4c3f21b79 100644
--- a/docs/pip.md
+++ b/docs/pip.md
@@ -42,8 +42,8 @@ of some other compile_pip_requirements rule that references these requirements
 
 It also generates two targets for running pip-compile:
 
-- validate with `bazel test <name>_test`
-- update with   `bazel run <name>.update`
+- validate with `bazel test [name]_test`
+- update with   `bazel run [name].update`
 
 
 **PARAMETERS**
diff --git a/python/pip_install/requirements.bzl b/python/pip_install/requirements.bzl
index af3c194d18..dd38c9df5b 100644
--- a/python/pip_install/requirements.bzl
+++ b/python/pip_install/requirements.bzl
@@ -39,8 +39,8 @@ def compile_pip_requirements(
 
     It also generates two targets for running pip-compile:
 
-    - validate with `bazel test <name>_test`
-    - update with   `bazel run <name>.update`
+    - validate with `bazel test [name]_test`
+    - update with   `bazel run [name].update`
 
     Args:
         name: base name for generated targets, typically "requirements".