Una guía de usuario , también conocida comúnmente como manual de usuario , tiene como objetivo ayudar a los usuarios a utilizar un producto, servicio o aplicación en particular. Por lo general, lo escribe un técnico, un desarrollador de productos o el personal de servicio al cliente de una empresa.
La mayoría de las guías de usuario contienen una guía escrita e imágenes asociadas. En el caso de las aplicaciones informáticas, lo habitual es incluir capturas de pantalla de la(s) interfaz(es) hombre-máquina, y los manuales de hardware suelen incluir diagramas claros y simplificados . El lenguaje utilizado se adapta al público objetivo , manteniendo la jerga al mínimo o explicada detalladamente.
Las secciones de un manual de usuario suelen incluir:
Se han encontrado guías de usuario con dispositivos antiguos. Un ejemplo es el Mecanismo de Antikythera , [1] una computadora analógica griega de 2.000 años de antigüedad que fue encontrada frente a la costa de la isla griega de Antikythera en el año 1900. En la portada de este dispositivo hay pasajes de texto que describen las características y el funcionamiento del el mecanismo.
A medida que la industria del software se desarrollaba, la cuestión de cómo documentar mejor los programas de software estaba indecisa. Este era un problema único para los desarrolladores de software, ya que los usuarios a menudo se sentían frustrados con los documentos de ayuda actuales. [2] Algunas consideraciones para escribir una guía de usuario que se desarrolló en este momento incluyen:
Antes de Unix , por ejemplo, GCOS , la documentación de mainframe eran páginas impresas, disponibles en las instalaciones para los usuarios (personal, estudiantes...), organizadas en carpetas de acero, encerradas juntas en un estante de lectura monolítico de acero, atornilladas a una mesa o mostrador, con páginas organizadas para actualizaciones de información modular, reemplazo, erratas y adiciones. [ cita necesaria ]
Los manuales de usuario y las guías de usuario para la mayoría de las aplicaciones de software de navegador y PC no triviales son documentos tipo libro con contenidos similares a la lista anterior. Pueden distribuirse en forma impresa o electrónica. Algunos documentos tienen una estructura más fluida con muchos enlaces internos. La Guía del usuario de Google Earth [4] es un ejemplo de este formato. El término guía suele aplicarse a un documento que aborda un aspecto específico de un producto de software. Algunos usos son la Guía de instalación , la Guía de introducción y varias guías prácticas . Un ejemplo es la Guía de introducción a Picasa . [5]
En algunas aplicaciones de software empresarial , donde los grupos de usuarios tienen acceso sólo a un subconjunto de la funcionalidad completa de la aplicación, se puede preparar una guía de usuario para cada grupo. Un ejemplo de este enfoque es el documento de Ayuda de Autodesk Topobase 2010 [6] , que contiene Guías del administrador , Guías del usuario y una Guía del desarrollador independientes .