diff --git a/docs/antora/modules/ROOT/pages/Cross_Builds.adoc b/docs/antora/modules/ROOT/pages/Cross_Builds.adoc
index dee9a88f2cd..dab7f3d5fce 100644
--- a/docs/antora/modules/ROOT/pages/Cross_Builds.adoc
+++ b/docs/antora/modules/ROOT/pages/Cross_Builds.adoc
@@ -29,6 +29,17 @@ mill show foo[2.12].suffix
 mill show foo[2.12].bigSuffix
 ----
 
+[NOTE]
+--
+Please be aware that some shells like `zsh` interpret square brackets differently, so quoting or masking might be needed.
+
+[source,zsh]
+----
+mill show foo\[2.10\].suffix
+mill show 'foo[2.10].suffix'
+mill show "foo[2.10].suffix"
+----
+--
 The modules each also have a `millSourcePath` of
 
 [source,text]
@@ -171,4 +182,4 @@ While the example `resolver` simply looks up the target `Cross` value for the
 cross-module instance with the same `crossVersion`, you can make the resolver
 arbitrarily complex. E.g. the `resolver` for `mill.scalalib.CrossSbtModule`
 looks for a cross-module instance whose `scalaVersion` is binary compatible
-(e.g. 2.10.5 is compatible with 2.10.3) with the current cross-module.
\ No newline at end of file
+(e.g. 2.10.5 is compatible with 2.10.3) with the current cross-module.