diff --git a/multiproject/plugin.jelly b/multiproject/plugin.jelly
index a7ed9605..f3d07c86 100644
--- a/multiproject/plugin.jelly
+++ b/multiproject/plugin.jelly
@@ -13,11 +13,17 @@
   <j:set var="maven.docs.dest" 
     value="${pom.getPluginContext('maven-xdoc-plugin').getVariable('maven.docs.dest')}"/>
 
+  <!--==================================================================-->
+  <!-- Default goal: builds sites for all subprojects                   -->
+  <!--==================================================================-->    
   <goal name="multiproject"
     description="Run the site goal of all subprojects"
     prereqs="multiproject:site">
   </goal>
 
+  <!--==================================================================-->
+  <!-- Builds sites for all subprojects                                 -->
+  <!--==================================================================-->    
   <goal name="multiproject:site"
     description="Run the site goal of all subprojects">
 
@@ -58,6 +64,9 @@
 
   </goal>
 
+  <!--==================================================================-->
+  <!-- Generate HTML files for navigation bar across projects.          -->
+  <!--==================================================================-->    
   <goal name="multiproject:create-nav">
     <mkdir dir="${maven.gen.docs}"/>
     <!-- get all projects for template processing -->
@@ -91,6 +100,9 @@
 
   </goal>
   
+  <!--==================================================================-->
+  <!-- Run specific sets of goals for all subprojects                   -->
+  <!--==================================================================-->
   <goal name="multiproject:goal" description="Run a given goal on all projects">
       <!-- FIXME: This should be a tag somewhere else as it's common to do tag param checking -->
       <j:if test="${empty(goal)}">
@@ -107,12 +119,11 @@ maven -Dgoal=clean multiproject:goal
         goals="${goal}"
         ignoreFailures="${maven.multiproject.ignoreFailures}"
       />
-  </goal>
-  
+  </goal> 
   
   <!--==================================================================-->
-  <!-- Builds all artifacts for all subproject                          -->
-  <!--==================================================================-->    
+  <!-- Builds all artifacts for all subprojects                         -->
+  <!--==================================================================-->
   <goal name="multiproject:artifact"
     description=" Builds all artifacts for all subproject">
 
@@ -155,7 +166,7 @@ maven -Dgoal=clean multiproject:goal
   <!-- Run 'artifact':install-snapshot for all subprojects              --> 
   <!--==================================================================-->    
   <goal name="multiproject:install-snapshot"
-    description="Run the site goal of all subprojects">
+    description="Run 'artifact':install-snapshot for all subprojects">
 
     <maven:reactor
       basedir="${maven.multiproject.basedir}"
@@ -189,8 +200,7 @@ maven -Dgoal=clean multiproject:goal
   
   <goal name="multiproject:deploy-callback">
      <attainGoal name="${maven.multiproject.type}:deploy"/>
-  </goal>
-  
+  </goal> 
   
   <!--==================================================================-->
   <!-- Run 'artifact':deploy-snapshot for all subprojects               -->
@@ -211,6 +221,4 @@ maven -Dgoal=clean multiproject:goal
      <attainGoal name="${maven.multiproject.type}:deploy-snapshot"/>
   </goal>
   
-  
-  
 </project>