diff --git a/checkstyle/xdocs/migrating.xml b/checkstyle/xdocs/migrating.xml
index 077544dd..712f2781 100644
--- a/checkstyle/xdocs/migrating.xml
+++ b/checkstyle/xdocs/migrating.xml
@@ -25,10 +25,16 @@
   </properties>
 
   <body>
+    <section name="Migrating from version 2.x to version 3.x">
+      <p>
+        The Checkstyle plugin version 3.x is using Checkstyle 4.x, allowing
+        the use of the new features in Java 5.
+      </p>
+    </section>
     <section name="Migrating from version 1.x to version 2.x">
       <p>
-        The Checkstyle plugin version 1.x was using Checkstyle 2.x and the new
-        2.x versions uses Checkstyle 3.x. The Maven goals for the Checkstyle
+        The Checkstyle plugin version 1.x was using Checkstyle 2.x, the 
+        2.x versions use Checkstyle 3.x. The Maven goals for the Checkstyle
         plugins have not changed and the way to invoke it can either be
         <code>maven checkstyle</code> or <code>maven checkstyle:report</code>.
       </p>