What tool/framework to use for technical documentation?
- by Pangea
We develop products and frameworks to be used with in our organization. I am looking for programmer friendly documentation tools. I have researched on few options sometime back but couldn't decide which one to use. I am looking for suggestions from the people who already used these tools.
docbook: springframework and hibernate use this format and this looks good. but I believe they have customized the default xslt/stylesheet. Can I copy and use their xslt and css (ofcourse with colors and images changed). Can I integrate the doc generation using maven?
wiki: this is not friendly to the technical document writers and the documentation doesn't look professional. versioning is also not possible I believe
word docs: this is what we use currently but it is hard to link and reuse common documents.
DITA?