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><PR_NUMBER></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>