diff --git a/esbuild/private/esbuild.bzl b/esbuild/private/esbuild.bzl
index ee5f35d..89d2966 100644
--- a/esbuild/private/esbuild.bzl
+++ b/esbuild/private/esbuild.bzl
@@ -433,5 +433,7 @@ esbuild_bundle = rule(
 Runs the esbuild bundler under Bazel
 
 For further information about esbuild, see https://esbuild.github.io/
+
+Note that esbuild may escape the sandbox and require extra configuration (for example, `resolveExtensions`), see https://github.com/aspect-build/rules_esbuild/issues/58
 """,
 )