diff --git a/doc/rules.md b/doc/rules.md
index 382c2b4d3..117be3360 100644
--- a/doc/rules.md
+++ b/doc/rules.md
@@ -1000,6 +1000,10 @@ mixed_language_library(<a href="#mixed_language_library-name">name</a>, <a href=
 
 Creates a mixed language library from a Clang and Swift library target     pair.
 
+Note: In the future `swift_library` will support mixed-langauge libraries.
+Once that is the case, this macro will be deprecated.
+
+
 **PARAMETERS**
 
 
diff --git a/mixed_language/mixed_language_library.bzl b/mixed_language/mixed_language_library.bzl
index 9ffa54204..9e27d78be 100644
--- a/mixed_language/mixed_language_library.bzl
+++ b/mixed_language/mixed_language_library.bzl
@@ -61,6 +61,9 @@ def mixed_language_library(
     """Creates a mixed language library from a Clang and Swift library target \
     pair.
 
+    Note: In the future `swift_library` will support mixed-langauge libraries.
+    Once that is the case, this macro will be deprecated.
+
     Args:
         name: The name of the target.
         alwayslink: If true, any binary that depends (directly or indirectly) on