Deciding a Documentation Tool

Why and How to Write

I’m trying to decide between the various tools I own in which to write the user guides for my various products. As well as thrashing out design ideas here on the blog I think actually writing stuff down is a good way to end analysis paralysis aka designer dithering.In the course of writing this evaluation (I really do think with my fingers) it became clear that one of the simplest deciding factors between publication tools is their internal and external referencing facility and how well it scales.

The other unsurprising dimension to my evaluations is that I’m deciding between document production and WYSIWYG editing tools. Productivity in writing is often increased by less control over layout, during the actual writing phase 🙂

Continue reading