How do you do your user-facing documentation?
limmeau: For #2, I recommend Sphinx (http://sphinx.pocoo.org/ ) as an alternative to DocBook. You write your documentation in reStructuredText (yet another extensible Wiki markup language) and generate HTML, PDF (via LaTeX), Windows help files, Eclipse help plugins etc.