From 0e10147d521769a42a6037e26bf939c7c0051bb3 Mon Sep 17 00:00:00 2001
From: Mattia Dal Ben <mattdibi@users.noreply.github.com>
Date: Mon, 21 Sep 2026 18:55:34 +0200
Subject: [PATCH] Document `reorderImports` option

---
 plugin-maven/README.md | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/plugin-maven/README.md b/plugin-maven/README.md
index 56aa4c18ce..5fcfbe46dd 100644
--- a/plugin-maven/README.md
+++ b/plugin-maven/README.md
@@ -344,11 +344,14 @@ Types in `java.lang` and in the file's own package are shortened without adding
   <style>GOOGLE</style>                       <!-- or AOSP (optional) -->
   <reflowLongStrings>true</reflowLongStrings> <!-- optional -->
   <formatJavadoc>false</formatJavadoc>        <!-- optional -->
+  <reorderImports>false</reorderImports>.     <!-- optional -->
   <!-- optional: custom group artifact (you probably don't need this) -->
   <groupArtifact>com.google.googlejavaformat:google-java-format</groupArtifact>
 </googleJavaFormat>
 ```
 
+Note: when enabling `AOSP` style, `reorderImports` needs to be enabled to apply the correct import order from [the AOSP guidelines](https://source.android.com/docs/setup/contribute/code-style#order-import-statements).
+
 ### palantir-java-format
 
 [homepage](https://github.com/palantir/palantir-java-format). [changelog](https://github.com/palantir/palantir-java-format/releases). [code](https://github.com/diffplug/spotless/blob/main/plugin-maven/src/main/java/com/diffplug/spotless/maven/java/PalantirJavaFormat.java).