diff --git a/src/main/starlark/builtins_bzl/common/cc/experimental_cc_static_library.bzl b/src/main/starlark/builtins_bzl/common/cc/experimental_cc_static_library.bzl
index 902f6933d27fc6..c1f24cf2c2ec90 100644
--- a/src/main/starlark/builtins_bzl/common/cc/experimental_cc_static_library.bzl
+++ b/src/main/starlark/builtins_bzl/common/cc/experimental_cc_static_library.bzl
@@ -244,6 +244,9 @@ def _cc_static_library_impl(ctx):
cc_static_library = rule(
implementation = _cc_static_library_impl,
doc = """
+This rule is currently experimental and can only be used with the
+--experimental_cc_static_library
flag.
+
Produces a static library from a list of targets and their transitive dependencies.
The resulting static library contains the object files of the targets listed in