Creo que un sistema de documentación interesante puede ser Sphinx. Lo estoy usando para la doc de mi tesis y funciona muy bien la salida a latex/PDF y a html. Es el sistema que usa la doc de Python.http://sphinx.pocoo.org/
SaludosNahuel