Currently:  <productnumber>  product-number  </productnumber>

    replace product-number with the product number. The product number changes
the release number (the last digit) when building a book with the tar or srpm
options. For example, setting the product number to 1 and building the book
using the make srpm-en-US command, would create an RPM file named PRODUCT -
DOCNAME -0.0-1.src.rpm. PRODUCT and DOCNAME are configured in the Makefile. 


Suggestion:

replace product-number with the edition (release) number of the book. The first
edition should be 1.0. Subsequent revisions should increment the 1.x to indicate
to readers that it is a revised edition.

Current:

  <issuenum>  issue-number  </issuenum>

    replace issue-number with the issue number. The issue number changes the
version number (the first two digits) when building a book with the tar or srpm
options. 

Suggested:

replace issue-number with the version number of the product the book applies to
(e.g: 5.1 for RHEL 5.1, 4.3 for JBoss EAP 4.3). If your book does not apply to a
product then put whatever you like.