diff --git a/plugin-gradle/README.md b/plugin-gradle/README.md
index d1b082ecca..c837f3655a 100644
--- a/plugin-gradle/README.md
+++ b/plugin-gradle/README.md
@@ -265,7 +265,7 @@ spotless {
 ### expandWildcardImports
 
 This step expands all wildcard imports to single class imports.
-To do this, [JavaParser](https://javaparser.org/) is used to parse the complete sourcecode and resolve the full qualified name of all used classes and static methods.
+To do this, [JavaParser](https://javaparser.org/) is used to parse the complete sourcecode and resolve the full qualified name of all used classes and static methods from the full classpath.
 This operation can be resource intensive when formatting many source files, so you may want to change to `forbidWildcardImports` when your codebase is cleaned and stable.
 
 ```
diff --git a/plugin-maven/README.md b/plugin-maven/README.md
index efb82242e2..93a19ae853 100644
--- a/plugin-maven/README.md
+++ b/plugin-maven/README.md
@@ -234,7 +234,7 @@ any other maven phase (i.e. compile) then it can be configured as below;
     </importOrder>
 
     <removeUnusedImports /> <!-- self-explanatory -->
-    <forbidWildcardImports /> <!-- yell if any import ends with '*' -->
+    <forbidWildcardImports /> <!-- yell if any import ends with '*'; or use expandWildcardImports, see below -->
     <forbidModuleImports /> <!-- yell if any module imports are found (Java 25+) -->
 
     <formatAnnotations />  <!-- fixes formatting of type annotations, see below -->
@@ -260,6 +260,16 @@ any other maven phase (i.e. compile) then it can be configured as below;
 <forbidWildcardImports/>
 ```
 
+### expandWildcardImports
+
+This step expands all wildcard imports to single class imports.
+To do this, [JavaParser](https://javaparser.org/) is used to parse the complete sourcecode and resolve the full qualified name of all used classes and static methods from the full classpath.
+This operation can be resource intensive when formatting many source files, so you may want to change to `forbidWildcardImports` when your codebase is cleaned and stable.
+
+```xml
+<expandWildcardImports/>
+```
+
 ### forbidModuleImports
 
 ```xml