Psaní v DocBooku je jednoduché, ale rozchoďte to! Mě se daří jen s obtížemi, a většinou to pracuje nějak tak napůl. Například to třeba pořádně nedělá tabulky, apod..
Já jsem napsal pár dokumentu v DocBooku a samotný princip se mi líbí. Ale pořád v tom přetězci převodů něco skřípe, raději jsem to vzdal a píšu dokumentaci jinak.
Píšu veškerou dokumentaci v Docbooku a pro ty, kdo se neradi hrabou přímo v XML dokumentech, mohu doporučit editor xmlmind na http://www.xmlmind.com/xmleditor/
Standardní edice je k dispozici zdarma a podporuje DocBook i Simple DocBook, psaní je skoro wysiwyg, ale vyžaduje od uživatele základní znalost struktury DocBooku. Možný je i trochu omezený přístup do XML zdrojáků. Navíc obsahuje už vlastní styly okamžitě použitelné pro konverzi do HTML, i když používám vlastní. Editor běží v Javě a v nastaveném českém prostředí se mi objevilo i počeštěné menu.