What is this?

A tutorial for hacker–writers

This booklet has two main goals:

The first is present a tutorial on writing documentation that will be used in a particular project at Cygnus.

The second is for me to clarify my thoughts on how I think the books we ship with should be structured.

A third goal, which is not as pressing, is that this booklet should become a tutorial for all people at Cygnus (and elsewhere; the GNOME project, for example is using DocBook) who will be writing notes for future incorporation into Cygnus documentation.

If you just want the tutorial with no further background information, please jump right to the chapter called Get going.