[MSITE-688] enhanced site:stage documentation

git-svn-id: https://svn.apache.org/repos/asf/maven/plugins/trunk@1738477 13f79535-47bb-0310-9956-ffa450edef68
diff --git a/src/main/java/org/apache/maven/plugins/site/deploy/SiteStageMojo.java b/src/main/java/org/apache/maven/plugins/site/deploy/SiteStageMojo.java
index a8a5938..3ecdd36 100644
--- a/src/main/java/org/apache/maven/plugins/site/deploy/SiteStageMojo.java
+++ b/src/main/java/org/apache/maven/plugins/site/deploy/SiteStageMojo.java
@@ -37,7 +37,7 @@
  * build work.
  * </p>
  * <p>This goal requires the site to already have been generated using the site goal,
- * such as by calling <code>mvn site</code></p>
+ * such as by calling <code>mvn site</code>.</p>
  *
  * @author <a href="mailto:vincent.siveton@gmail.com">Vincent Siveton</a>
  * @version $Id$
diff --git a/src/site/apt/index.apt.vm b/src/site/apt/index.apt.vm
index d809904..8a18f59 100644
--- a/src/site/apt/index.apt.vm
+++ b/src/site/apt/index.apt.vm
@@ -53,7 +53,8 @@
 
    * {{{./stage-mojo.html}site:stage}} generates a site in a local staging or mock directory based on the site URL
      specified in the <<<\<distributionManagement\>>>> section of the POM. It can be used
-     to test that links between module sites in a multi module build works.
+     to test that links between module sites in a multi module build work. This goal requires the site to already have been
+     generated using the site goal, such as by calling <<<mvn site>>>.
 
    * {{{./stage-deploy-mojo.html}site:stage-deploy}} deploys the generated site to a staging or mock directory to the site
      URL specified in the <<<\<distributionManagement\>>>> section of the POM.