diff --git a/python/private/py_info.bzl b/python/private/py_info.bzl
index 2a02685362..ef654c303e 100644
--- a/python/private/py_info.bzl
+++ b/python/private/py_info.bzl
@@ -112,6 +112,9 @@ Type definition files (usually `.pyi` files) for the Python modules provided by
 this target. Usually they describe the source files listed in
 `direct_original_sources`. This field is primarily for static analysis tools.
 
+These files are _usually_ build-time only and not included as part of a runnable
+program.
+
 :::{note}
 This may contain implementation-specific file types specific to a particular
 type checker.
@@ -190,6 +193,9 @@ Python modules for this target and its transitive dependencies. this target.
 Usually they describe the source files listed in `transitive_original_sources`.
 This field is primarily for static analysis tools.
 
+These files are _usually_ build-time only and not included as part of a runnable
+program.
+
 :::{note}
 This may contain implementation-specific file types specific to a particular
 type checker.