fix DeployAtEnd failures

src/main/java/org/apache/maven/plugins/deploy/DeployMojo.java

@@ -73,8 +73,17 @@ public class DeployMojo
     private List<MavenProject> reactorProjects;
 
     /**
-     * Whether every project should be deployed during its own deploy-phase or at the end of the multimodule build. If
-     * set to {@code true} and the build fails, none of the reactor projects is deployed.
+     * Whether every project should be deployed during its own deploy-phase or at the end of the
+     * multi-module build. If set to {@code true} and the build fails, none of the reactor projects
+     * is deployed.
+     *
+     * In order for this flag to work properly, all modules of the multi-module build must set this
+     * property to the same value and all modules must have the same value for the skip property.
+     * If this property or the skip property are inconsistently set in different projects, any
+     * project with this property set to true will not be deployed either immediately nor at the
+     * end of the build.  See details in
+     * <a href="https://issues.apache.org/jira/browse/MDEPLOY-226">MDEPLOY-226</a>
+     *
      * <strong>(experimental)</strong>
      * 
      * @since 2.8

src/site/fml/faq.fml

@@ -77,6 +77,28 @@ under the License.
 </plugin>]]></source>
        </answer>
      </faq>
+   <faq id="deployAtEnd">
+     <question>Why isn't <i>deployAtEnd</i> property working?</question>
+     <answer>
+       <p>
+       The <i>deployAtEnd</i> property must be set consistently in all modules and the <i>skip</i>
+       property must be set consistently in all modules.  If either property is not consistent, any
+       module with <i>deployAtEnd</i> set to true will not be deployed.
+       </p>
+       <p>
+       An alternative to using <i>deployAtEnd</i> is to have the build script invoke Maven twice:
+<pre>
+ mvn install
+ mvn deploy:deploy
+</pre>
+       If you need to both installAtEnd and deployAtEnd, use the something like the following:
+<pre>
+ mvn verify
+ mvn install:install deploy:deploy
+</pre>
+       </p>
+     </answer>
+   </faq>
      <faq id="deploy_deploy">
        <question>What does the message "The packaging for this project did not assign a file to the build artifact" mean when I run <code>deploy:deploy</code>?</question>
        <answer>