J.1. DocBook #

Os arquivos-fonte da documentação são escritos em DocBook, uma linguagem de marcação definida em XML. No que se segue, são usados os termos DocBook e XML indiferentemente, mas tecnicamente não são intercambiáveis.

O DocBook permite que o autor especifique a estrutura e o conteúdo de um documento técnico, sem se preocupar com os detalhes da apresentação. O estilo do documento define como o conteúdo é apresentado em uma das várias formas finais. O DocBook é mantido pelo OASIS DocBook TC. A página DocBook Technical Committee Document Repository possui uma boa documentação introdutória e de referência, e também há o livro DocBook 5.2: The Definitive Guide de Norman Walsh publicado pela O’Reilly completo para o seu prazer de leitura online. O FreeBSD Documentation Project também utiliza o DocBook e possui algumas informações úteis, incluindo algumas diretrizes de estilo que podem valer a pena serem levadas em consideração.