Chapter 2. Marking up content the right way

Table of Contents

The overall structure
Marking up common elements
Marking up rather rare elements
Step-by-step instructions

The overall structure

The basic structure of the codumentation is a set containing books focusing on a specific target group, such as developers or users. Those books contain parts that group together chapters, which contain (nested) sections.

In the top level directory an index.xml file is the root of the documentation, on the same level one file per book includes the corresponding parts.

Every book has it's own directory, containing one file per part. For those parts exist corresponding directories containing one file per chapter. If sections contain a lot of content, they may also be split into separate files each.