Has diseñado un producto prácticamente perfecto o creado un gran programa de software. Después, has contratado a algunos de los mejores escritores técnicos para escribir un manual de ayuda fácil de usar que resuelva problemas de uso. Quieres que los usuarios de tu producto empiecen a disfrutar del mismo desde el principio. Los escritores técnicos hicieron un trabajo fantástico y tu equipo de experiencia de usuario lo ha confirmado.
Pero después de lanzar tu producto o presentar una actualización, pareces estar gastando mucho más en atención al cliente. En muchos casos, las respuestas que buscan los usuarios están dentro del manual de usuario. Así que ahora te estás haciendo la misma pregunta que muchos fabricantes y desarrolladores: ¿Se leen el manual de ayuda alguna vez los usuarios de los productos?

Lee Mas →

Escoger el formato adecuado para publicar tus archivos de ayuda puede resultar complicado, especialmente si estás creando tu primer manual de ayuda y quieres evitar los mayores errores que cometen los autores primerizos de manuales de ayuda. El formato correcto permitirá a tus usuarios tener acceso a sus archivos de ayuda exactamente como y cuando lo necesiten.
Si estás utilizando una herramienta de creación de documentación de ayuda (y deberías, porque permiten redactar mejores documentos de ayuda en la mitad de tiempo), publicar en múltiples formatos no debería suponer ningún problema.
La gran pregunta a la que hoy damos respuesta es si deberías publicar un manual impreso (copia en papel) o un manual en pantalla (PDF, CHM, HTML basado en web, formato eBook…).

Lee Mas →

Muchos autores de manuales de ayuda han descubierto que las herramientas de creación de documentación de ayuda o HAT son una gran manera de de redactar manuales rápida y fácilmente, así como otros documentos de ayuda. No mucha gente se para a pensar que el uso de los programas HAT en realidad beneficia a todo el mundo, incluyendo el fabricante del producto que paga por el manual y el usuario final del producto.

Lee Mas →

Microsoft Word es un programa de software increíble. Permite a los usuarios redactar rápida y fácilmente cualquier cosa, desde un trabajo escolar hasta una carta profesional. La mayor ventaja de Microsoft Word es su familiaridad para los usuarios, es un programa con la que la mayoría de nosotros hemos crecido, utilizándolo tanto en el colegio como en la oficina. Para muchas personas sigue siendo la opción natural a la hora de redactar cualquier cosa en un entorno profesional. Y en la mayoría de los casos Microsoft Word es perfecto, pero hay algunas aplicaciones, incluyendo la redacción de documentación de productos, para los que no funciona tan bien.
Hay muchas razones por las que Microsoft Word no es la herramienta adecuada para ayudarte a escribir la documentación de tu producto, estas son solo cinco de ellas.

Lee Mas →

Redactar documentación de ayuda es un trabajo duro, los autores técnicos tienen que explicar con claridad cada función del producto. La documentación debe escribirse para una amplia variedad de usuarios de producto, ya que no todos tendrán el mismo nivel de experiencia técnica ni idénticas expectativas.
A pesar de estas consideraciones, en muchos casos los autores técnicos descubren que redactar la documentación es la parte más sencilla del proceso. Una vez escrito todo lo que tienen que decir para cubrir el tema de manera adecuada, deben darle formato para que sea accesible y fácil de leer en una variedad de formatos. Entre los formatos que pueden ser necesarios se incluyen PDF, Word, HTML online, quizá HLP o CHM. El proceso completo necesario para dar formato puede requerir gran cantidad de tiempo, cuando lo que la mayoría de los autores técnicos quieren de verdad es concentrarse en escribir documentación de ayuda de gran calidad, y no tener que pasarse una eternidad preocupándose por cómo se muestran sus páginas en diferentes dispositivos.
Cuando la documentación está terminada por fin, a menudo no es el final del proceso, porque cada vez que se revisa el producto, es necesario modificar la documentación para que incluya las funciones nuevas o actualizadas.

Lee Mas →