diff --git a/multiproject/xdocs/properties.xml b/multiproject/xdocs/properties.xml
index cf0403cf..9603a2e1 100644
--- a/multiproject/xdocs/properties.xml
+++ b/multiproject/xdocs/properties.xml
@@ -207,10 +207,20 @@
           <td>No</td>
           <td>
             <p>
-              Defines the list of goals that should be executed when
-              running <code>multiproject:site</code>. This is useful
-              if you need to run additional goals than <code>site</code> 
-              when generating the site.
+              Defines the list of goals to execute on each subproject when
+              running <code>multiproject:site</code>.
+              This property specifies the complete list of goals to run,
+              not in addition to any default ones.
+            </p>
+            <p>
+              This is useful when needing to run goals in addition to,
+              or other than, <code>site</code> on the subproject sites.
+            </p>
+            <p>
+              Note: when setting this property,
+              if you want <code>site</code> to run on the subprojects,
+              you must specify <code>site</code>
+              in the list of goals to execute.
             </p>
             <p>
               Default value is <code>site</code>.