JBoss.org Community Documentation
This document introduces the unified DocBook system for JBoss.org documentation based on Maven2. Using this system provides the following benefits:
The DocBook libraries and all other dependencies are stored in Maven plugins located in the JBoss public maven repository. This allows the entire build environment to be automatically downloaded and configured from just a single pom.xml
file stored in a project's docs
directory.
Styles are also stored in Maven plugins so that they can be managed from a central location. This allows updates to be automatically downloaded when new designs are created or bugs are fixed.
It provides a default style based on the JBoss.org community-driven theme that looks clean, fresh and modern.
Custom styles can easily be created for individual projects, or groups of related projects, to cater for different requirements. For example some projects may have their own logos or wish to have collapsable menus at the start of each chapter.
The build process is simplified and standardized. Just
follow the instructions in this guide to setup your docs
directory and copy a very simple pom.xml
file.
If you have any questions, please feel free to contact Mark Newton (Content Lead) for more information.