Index: xdocs/start/ten-minute-test.xml
===================================================================
--- xdocs/start/ten-minute-test.xml	(revision 328913)
+++ xdocs/start/ten-minute-test.xml	(working copy)
@@ -134,8 +134,15 @@
           <tr>
             <td><code>xdocs</code></td>
             <td>
-              This contains the documentation that will be transformed into HTML and published as a project
-              site.
+              This contains the documentation that will be transformed into
+              HTML and published as a project site.
+              <strong>Note</strong>: by defaulting the xdocs location to the
+              top level directory, Maven 1.x violates the directory structure
+              <a href="../reference/conventions.html#Directory_Structure">conventions</a>
+              adopted in Maven 2, where it defaults to
+              <code>src/site/xdoc</code>. You can make your project
+              layout compatible with Maven 2 by overriding the
+              <code>maven.docs.src</code> property.
             </td>
           </tr>
         </table>