added simple documentation on the ReportPlugin XML representation and the way Maven 3 handles old reporting section
git-svn-id: https://svn.apache.org/repos/asf/maven/shared/trunk@1143215 13f79535-47bb-0310-9956-ffa450edef68
diff --git a/src/site/apt/index.apt b/src/site/apt/index.apt
new file mode 100644
index 0000000..89f1acd
--- /dev/null
+++ b/src/site/apt/index.apt
@@ -0,0 +1,41 @@
+ -----
+ Maven Reporting Executor
+ -----
+ Hervé Boutemy
+ -----
+ 2011-07-06
+ -----
+
+Maven Reporting Executor
+
+ Classes to manage report plugin executions with Maven 3.
+
+ Report plugins can be configured in <<<\<configuration\>>>> element of <<<maven-site-plugin>>> or any other
+ report building plugin with following XML model:
+
++----
+<reportPlugins>
+ <plugin>
+ <groupId/>
+ <artifactId/>
+ <version/>
+ <configuration/>
+ <reports/>
+ <reportSets>
+ <reportSet>
+ <id/>
+ <configuration/>
+ <reports/>
+ </reportSet>
+ </reportSets>
+ </plugin>
+</reportPlugins>
++----
+
+ Notice: this is the model from plugins in <<<\<reporting\>>>> section of POM without <<<\<inherited\>>>> element
+ and with <<<\<reports\>>>> list that simplifies reports configuration in usual cases.
+
+ Maven 3 core makes an automatic transformation of <<<\<reporting\>>>> POM section to <<<maven-site-plugin>>>
+ configuration through the
+ {{{http://maven.apache.org/ref/current/maven-model-builder/apidocs/org/apache/maven/model/plugin/ReportingConverter.html}ReportingConverter}}
+ component.
\ No newline at end of file
