This document introduces the new unified DocBook system for JBoss
documentation in the public CVS tree. There are a couple of reasons
why we did this.
- It provides a unified set of styles to make sure that all
JBoss DocBooks have a consistent look and feel.
- The styles can be managed from a central location. We can
design new styles or fix bugs without worrying about
"deployment" issues.
- The libraries and build scripts can also be managed from
a central location.
- The build process is simplified and standardized. Just
follow the simple instructions in this guide to setup your docs
directory and copy a very simple build.xml
file.
- Last but not least, we can reduce the duplication of
style sheets, XSLs and libraries in the system.
If you have questions, please feel free to contact Michael Yuan
or Norman Richards for more information.