Cuál es el mejor paquete de software para escribir un manual de usuario técnico?

Realmente depende de su audiencia, propósito y contenido/longitud.

Si está escribiendo memos cortos, guías de referencia o notas de lanzamiento para desarrolladores e ingenieros, entonces MS Word lo hará bien, especialmente si es un documento de 10 o 20 páginas.

Sin embargo, cuanto más largo sea el documento, más problemático y costoso empieza a ser MS Word debido a los conocidos problemas en las secuencias de numeración y la falta de páginas maestras. Un documento de Word de mil páginas, por ejemplo, puede de repente estropear la numeración de los párrafos en medio de la página 500 y corregirlo puede convertirse en una locura, ya que la numeración de Word es muy sensible a los saltos de sección y de página que se dan a lo largo de un documento típico de Word. Usted corrige la numeración en un punto y cree que ha terminado hasta que descubre que sus números se han desajustado en algún otro rincón del mismo documento.

Otro problema de Word es su falta de funcionalidad de fuente única incorporada. Hay aplicaciones de terceros como SmartDocs que le permite generar múltiples entregables a partir de un único conjunto de archivos de origen, pero también es necesario utilizar SharePoint para poder hacer eso.

Un software más integrado y robusto sería algo como Adobe FrameMaker o Flare. No he utilizado personalmente Flare pero siempre he oído hablar bien de él en nuestra comunidad de escritores técnicos.

Tengo décadas de experiencia con FrameMaker y puedo decir con seguridad que se pueden generar documentos de MILES de páginas con FM y siempre ofrecerá resultados fiables. Está construido sobre un paradigma de páginas maestras para que puedas cambiar de una plantilla de página a otra simplemente asignándola a la página que quieras. Luego puede generar un archivo de ayuda (HTML) a partir de él fácilmente utilizando su aplicación hermana RoboHelp.

Para la correspondencia y la documentación en la oficina, MS Office y Word estarían bien. Pero para generar documentos técnicos largos con tablas, listas, y cambiar las plantillas de las páginas, yo iría con FrameMaker+RoboHelp o Flare.