From babeeb619ce69ab7470ab4ea6c0d55b20336e2db Mon Sep 17 00:00:00 2001
From: bsorrentino <bartolomeo.sorrentino@gmail.com>
Date: Sun, 12 Aug 2018 15:39:42 +0200
Subject: [PATCH] Issue #72 - Add notes to documentation

---
 pom.xml                 | 55 +++++++++++++++++++++++++++--------------
 src/site/markdown/qa.md |  8 ++++++
 src/site/site.xml       |  1 +
 3 files changed, 45 insertions(+), 19 deletions(-)
 create mode 100644 src/site/markdown/qa.md

diff --git a/pom.xml b/pom.xml
index 45f9df2..d32e037 100644
--- a/pom.xml
+++ b/pom.xml
@@ -83,7 +83,7 @@ This plugin could be considered the 'alter ego' of maven apt plugin http://mojo.
 
   <dependencyManagement>
       <dependencies>
-    <dependency>      
+    <dependency>
       <groupId>org.codehaus.plexus</groupId>
       <artifactId>plexus-compiler-api</artifactId>
       <version>2.8.2</version>
@@ -100,7 +100,7 @@ This plugin could be considered the 'alter ego' of maven apt plugin http://mojo.
       <scope>compile</scope>
     </dependency>
       </dependencies>
-  </dependencyManagement>  
+  </dependencyManagement>
   <dependencies>
       <dependency>
           <groupId>org.apache.maven</groupId>
@@ -125,7 +125,7 @@ This plugin could be considered the 'alter ego' of maven apt plugin http://mojo.
           <artifactId>plexus-utils</artifactId>
           <version>3.0.15</version>
       </dependency>
-          <dependency>      
+          <dependency>
       <groupId>org.codehaus.plexus</groupId>
       <artifactId>plexus-compiler-api</artifactId>
     </dependency>
@@ -147,22 +147,6 @@ This plugin could be considered the 'alter ego' of maven apt plugin http://mojo.
 
   </dependencies>
 
- <reporting>
- <plugins>
-	<plugin>
-	    <groupId>org.apache.maven.plugins</groupId>
-	    <artifactId>maven-plugin-plugin</artifactId>
-	    <version>3.1</version>
-	</plugin>
-	
-	<plugin>
-	    <groupId>org.apache.maven.plugins</groupId>
-	    <artifactId>maven-project-info-reports-plugin</artifactId>
-	    <version>2.4</version>
-	</plugin>
- </plugins>
- </reporting>
- 
   <build>
 
       <plugins>
@@ -219,8 +203,40 @@ This plugin could be considered the 'alter ego' of maven apt plugin http://mojo.
                       <version>3.4</version>
                       <scope>runtime</scope>
                   </dependency>
+
+                  <dependency>
+                      <groupId>org.apache.maven.reporting</groupId>
+                      <artifactId>maven-reporting-exec</artifactId>
+                      <version>1.2</version>
+                  </dependency>
+
+                  <dependency>
+                      <groupId>org.apache.maven.doxia</groupId>
+                      <artifactId>doxia-module-markdown</artifactId>
+                      <version>1.6</version>
+                  </dependency>
+
               </dependencies>
               <configuration>
+                  <reportPlugins>
+
+                      <plugin>
+                          <groupId>org.apache.maven.plugins</groupId>
+                          <artifactId>maven-plugin-plugin</artifactId>
+                          <version>3.4</version>
+                      </plugin>
+
+                      <plugin>
+                          <groupId>org.apache.maven.plugins</groupId>
+                          <artifactId>maven-project-info-reports-plugin</artifactId>
+                          <version>2.4</version>
+
+                          <configuration>
+                              <!-- @see https://www.mkyong.com/maven/maven-site-build-is-very-slow-dependency-report/ -->
+                              <dependencyLocationsEnabled>false</dependencyLocationsEnabled>
+                          </configuration>
+                      </plugin>
+                  </reportPlugins>
               </configuration>
           </plugin>
 
@@ -236,6 +252,7 @@ This plugin could be considered the 'alter ego' of maven apt plugin http://mojo.
       </extensions>
       -->
 
+
   </build>
 
   <profiles>
diff --git a/src/site/markdown/qa.md b/src/site/markdown/qa.md
new file mode 100644
index 0000000..75bb4ee
--- /dev/null
+++ b/src/site/markdown/qa.md
@@ -0,0 +1,8 @@
+## Questions & Answers
+
+
+### Multiple executions of plugin
+
+Referring to issue [72](https://github.com/bsorrentino/maven-annotation-plugin/issues/72), apparently the default configuration of the sources plugin doesn't play nice with plugins bound to the `generate-sources` phase.
+
+In the case you having this issue please refer to: [How to prevent generate-sources phase executing twice](http://blog.peterlynch.ca/2010/05/maven-how-to-prevent-generate-sources.html)
diff --git a/src/site/site.xml b/src/site/site.xml
index 67da1e4..ad3f04a 100644
--- a/src/site/site.xml
+++ b/src/site/site.xml
@@ -20,6 +20,7 @@
     	<item name="Summary" href="project-summary.html"/>
     	<item name="Goals" href="plugin-info.html"/>
     	<item name="Usage" href="usage.html"/>
+      <item name="Q&amp;A" href="qa.html"/>
 
     </menu>