Minor additions to the Committer how-to
diff --git a/src/main/docgen/book.xml b/src/main/docgen/book.xml
index 22a71f1..80f2a26 100644
--- a/src/main/docgen/book.xml
+++ b/src/main/docgen/book.xml
@@ -1336,7 +1336,8 @@
 
           <listitem>
             <para><literal><replaceable>&lt;PR_NUMBER&gt;</replaceable></literal>
-            is the pull request number that Github shows prominently</para>
+            is the pull request number that Github shows prominently after a
+            <quote>#</quote></para>
           </listitem>
         </itemizedlist>
 
@@ -1391,9 +1392,9 @@
           <listitem>
             <para>The official release is provided as source code to build the
             project (src tar.gz). For the convenience of users the release is
-            also accompanied by compiled binaries (bin tar.gz). Both artifacts
-            are downloadable from the Apache Software Foundation, as
-            usual</para>
+            also accompanied by compiled binaries (bin tar.gz, which also
+            contains the documentation). Both artifacts are downloadable from
+            the Apache Software Foundation, as usual</para>
           </listitem>
 
           <listitem>