diff --git a/docs/js_run_devserver.md b/docs/js_run_devserver.md
index f95c9a371..6ac268f33 100644
--- a/docs/js_run_devserver.md
+++ b/docs/js_run_devserver.md
@@ -87,6 +87,8 @@ underlying npm packages.
 Supports running with [ibazel](https://github.com/bazelbuild/bazel-watcher).
 Only `data` files that change on incremental builds are synchronized when running with ibazel.
 
+Note that the use of `alias` targets is not supported by ibazel: https://github.com/bazelbuild/bazel-watcher/issues/100
+
 
 **PARAMETERS**
 
diff --git a/js/private/js_run_devserver.bzl b/js/private/js_run_devserver.bzl
index eb0bf1d14..7f784ff63 100644
--- a/js/private/js_run_devserver.bzl
+++ b/js/private/js_run_devserver.bzl
@@ -206,6 +206,8 @@ def js_run_devserver(
     Supports running with [ibazel](https://github.com/bazelbuild/bazel-watcher).
     Only `data` files that change on incremental builds are synchronized when running with ibazel.
 
+    Note that the use of `alias` targets is not supported by ibazel: https://github.com/bazelbuild/bazel-watcher/issues/100
+
     Args:
         name: A unique name for this target.