diff --git a/pmd/xdocs/credits.xml b/pmd/xdocs/credits.xml
index d938709cb3..0ffd4c6fd7 100644
--- a/pmd/xdocs/credits.xml
+++ b/pmd/xdocs/credits.xml
@@ -40,6 +40,7 @@
         </subsection>
         <subsection name="Contributors">
         <ul>
+            <li>Phil Shaw - documentation suggestions</li>
             <li>Todd Wright - XPath port of AtLeastOneConstructorRule, ConfusingTernaryExpression rule, reported missing ASTUnaryExpressionNotPlusMinus nodes</li>
             <li>Sreenivasa Viswanadha - reminded me to use BufferedInputStreams, grammar cleanup for Ctrl-Z problem</li>
             <li>Austin Moore - Integration with Omnicore's CodeGuide IDE</li>
diff --git a/pmd/xdocs/integrations.xml b/pmd/xdocs/integrations.xml
index 8aa14da06c..e40482f702 100644
--- a/pmd/xdocs/integrations.xml
+++ b/pmd/xdocs/integrations.xml
@@ -63,6 +63,12 @@
   </tr>
   </table>
       </subsection>
+        <subsection name="General comments">
+            <p>A general note - most plugins include the PMD jar file, which has the rulesets
+            inside it.  So even though the rulesets parameter that some plugins
+            use (i.e., "rulesets/unusedcode.xml") looks like a filesystem reference, it's really
+            being used by a getResourceAsStream() call to load it out of the PMD jar file.</p>
+        </subsection>
       <subsection name="Eclipse">
 <p>
 Integration into Eclipse is accomplished through the extensive
diff --git a/pmd/xdocs/running.xml b/pmd/xdocs/running.xml
index a6c558ff40..92771518d8 100644
--- a/pmd/xdocs/running.xml
+++ b/pmd/xdocs/running.xml
@@ -22,6 +22,11 @@ Avoid unused local variables such as 'fr'
 
 C:\tmp\pmd-1.8\pmd\etc&gt;
     </source>
+       <p>Note that the PMD binary distribution includes the ruleset files
+       inside the jar file - even though the "rulesets/unusedcode.xml" parameter
+ above looks like a filesystem reference, it's really being used by a getResourceAsStream() call
+ to load it out of the PMD jar file.  And the same applies to the example below.</p>
+
        <li>If you are using JDK 1.3 or you just want to run PMD without the batch file, you can do a:</li>
        <source>
 C:\data\pmd\pmd>java -cp lib\pmd-1.8.jar;lib\xercesImpl-2.0.2.jar;