diff --git a/apple/internal/experimental_mixed_language_library.bzl b/apple/internal/experimental_mixed_language_library.bzl
index 915b587dbc..8dbc9ec191 100644
--- a/apple/internal/experimental_mixed_language_library.bzl
+++ b/apple/internal/experimental_mixed_language_library.bzl
@@ -209,15 +209,12 @@ def experimental_mixed_language_library(
     This is an experimental macro that supports compiling mixed Objective-C and
     Swift source files into a static library.
 
-    Due to the build performance reason, in general it's not recommended to
+    Due to build performance reasons, in general it's not recommended to
     have mixed Objective-C and Swift modules, but it isn't uncommon to see
-    mixed language modules in some old codebases. This macro is meant to make
+    mixed language modules in some codebases. This macro is meant to make
     it easier to migrate codebases with mixed language modules to Bazel without
     having to demix them first.
 
-    This macro only supports a simple use case of mixed language
-    modules, it does not support header maps.
-
     Args:
         name: A unique name for this target.
         deps: A list of targets that are dependencies of the target being
diff --git a/doc/rules-apple.md b/doc/rules-apple.md
index be06f6aa5f..b9849012df 100755
--- a/doc/rules-apple.md
+++ b/doc/rules-apple.md
@@ -385,15 +385,12 @@ Compiles and links Objective-C and Swift code into a static library.
 This is an experimental macro that supports compiling mixed Objective-C and
 Swift source files into a static library.
 
-Due to the build performance reason, in general it's not recommended to
+Due to build performance reasons, in general it's not recommended to
 have mixed Objective-C and Swift modules, but it isn't uncommon to see
-mixed language modules in some old codebases. This macro is meant to make
+mixed language modules in some codebases. This macro is meant to make
 it easier to migrate codebases with mixed language modules to Bazel without
 having to demix them first.
 
-This macro only supports a simple use case of mixed language
-modules, it does not support header maps.
-
 
 **PARAMETERS**