Los documentos de ayuda ahora son más fáciles de escribir

Los documentos de ayuda son más fáciles de escribir [Featured]

Escribir un manual de ayuda a menudo puede ser un proceso muy frustrante. Todo el mundo entiende que el objetivo final es crear un manual que ayude a los usuarios a solucionar sus dudas con tus productos y entender todas sus funciones. La dificultad estriba en cómo conseguirlo.. La mayoría de los autores habrán tenido la experiencia de quedarse mirando un papel o una pantalla en blanco, preguntándose cómo empezar su nuevo libro o artículo. Al escribir documentación de ayuda, el principal problema es decidir cómo tratar el tema.

Identificar las funciones de tu producto

La forma más sencilla de empezar es identificar todas las funciones independientes del producto y después escribir sobre cada una en sucesión.
Es útil explicar cuál es el propósito de cada función al principio de cada sección, y no limitarse a ofrecer una guía paso a paso. No todos los usuarios estarán tan familiarizados como tú con tus productos y quizá no se den cuenta de todo lo que pueden hacer con tu producto. Muchos de nosotros nos hemos encontrado en la situación de haber comprado un producto para hacer una cosa y después descubrir que también se puede utilizar de otra forma, o para hacer otra cosa en la que ni siquiera habíamos pensado al comprarlo.

Beneficios de utilizar una herramienta HAT

Una de las maneras más fáciles de escribir tu documento de ayuda es utilizar una HAT, o herramienta de creación de documentación de ayuda. Puedes escribir tu manual utilizando el procesador de texto integrado, igual que harías con un documento de Word normal, pero también tendrás la oportunidad de aprovechar las gran cantidad de funciones incluidas en el paquete de software.
Utilizar estas funciones te permitirá crear el manual de ayuda más rápido y actualizarlo más fácilmente siempre que debas incluir una nueva versión del producto.

Estas funciones incluyen:

  • Un editor de temas – Podrás revisar con rapidez todos los temas que hayas escrito y asegurarte de haber cubierto todos los asuntos detalladamente y de un modo que resulte fácil de entender para el usuario del producto.
  • Una biblioteca audiovisual – Poder añadir elementos audiovisuales como imágenes o vídeos a tu documento puede ahorrarte una buena cantidad de texto y explicar algunas funciones con facilidad.
  • Generación en múltiples formatos – Crea documentos de ayuda en una amplia gama de formatos para que tus usuarios puedan acceder a la información del modo que les resulte más cómodo. Solo tienes que escribir el documento una vez y cuando esté listo, producirlo en todos los formatos que necesites, como por ejemplo PDF, ePub, HTML, etc.
  • Generación condicional de contenido – Si quieres crear documentos de ayuda parecidos con ligeras diferencias, por ejemplo para las diferentes versiones de un producto, o para producir documentos en diferentes formatos, puedes utilizar la generación condicional de contenido para hacerlo con gran facilidad.

Las herramientas de creación de documentación de ayuda son la mejor manera de escribir tus documentos de ayuda rápidamente y ofrecer a los usuarios de tus productos el mejor nivel de servicio, para que puedan encontrar las respuestas que necesitan con rapidez.

Ver también...

cuando los manuales y documentos de ayuda salen mal [Featured]
Cuando los manuales de ayuda salen mal

Casi todo el mundo tiene al menos una historia de terror relacionada con la documentación de ayuda. Puede ser un manual de ayuda escrito o traducido tan mal que es imposible de entender, o un producto …

Lee Mas →
Un cliente feliz [Featured]
Usa una herramienta de creación de documentación de ayuda para reducir tus costes de atención al cliente

¿Cuáles son los principales costes del producto para tu negocio? Todo el mundo sabe que crear un producto nuevo cuesta dinero. Hay costes asociados al diseño, las pruebas, la fabricación del producto, …

Lee Mas →
Schoolgirl with books on head © CollegeDegrees360 -- https://www.flickr.com/photos/83633410@N07/7658034524/in/photostream/ [Featured]
Ventajas de utilizar software de creación de documentación de ayuda en proyectos académicos

Crear documentación de ayuda para productos tiene muchas similitudes con un proyecto académico típico. Un proyecto académico a menudo deberá: Hablar de un tema en profundidad, tratando cada aspecto …

Lee Mas →
 Los 7 mejores formatos para publicar tus manuales de ayuda [Featured]
Los 7 mejores formatos para publicar tus manuales de ayuda

Solo hay una regla para elegir el mejor formato para publicar manuales de ayuda: elegir el formato que permita a los usuarios acceder fácilmente al manual cuando y como lo necesiten. Un factor …

Lee Mas →