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. Suele estar escrita por un técnico, un desarrollador de productos o el personal de atención al cliente de una empresa.
La mayoría de las guías de usuario contienen tanto una guía escrita como imágenes asociadas. En el caso de las aplicaciones informáticas, es habitual incluir capturas de pantalla de las interfaces hombre-máquina, y los manuales de hardware suelen incluir diagramas claros y simplificados . El lenguaje utilizado se adapta al público al que va dirigido , y se reduce al mínimo la jerga o se explica detalladamente.
Las secciones de un manual de usuario a menudo incluyen:
.jpg/1280px-Antikythera_mechanism_clockface,_1st-2nd_century_BC,_Greece_(model).jpg)
Se han encontrado manuales de usuario en dispositivos antiguos. Un ejemplo es el Mecanismo de Antikythera , [1] una computadora analógica griega de 2000 años de antigüedad que fue encontrada en la costa de la isla griega de Antikythera en el año 1900. En la tapa de este dispositivo hay pasajes de texto que describen las características y el funcionamiento del mecanismo.
A medida que la industria del software se fue desarrollando, la cuestión de cómo documentar mejor los programas de software no estaba resuelta. Este era un problema exclusivo de los desarrolladores de software, ya que los usuarios a menudo se frustraban con los documentos de ayuda actuales. [2] Algunas consideraciones para escribir una guía de usuario que se desarrolló en esta época incluyen:
Antes de Unix , por ejemplo, GCOS , la documentación del mainframe consistía en páginas impresas, disponibles localmente para los usuarios (personal, estudiantes...), organizadas en carpetas de acero, bloqueadas entre sí en un estante de lectura de acero monolítico, atornillado a una mesa o mostrador, con páginas organizadas para actualizaciones de información modulares, reemplazos, erratas y adendas. [ cita requerida ]
Los manuales y guías de usuario de la mayoría de las aplicaciones de software para PC y navegadores no triviales son documentos de 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 se aplica a menudo a un documento que aborda un aspecto específico de un producto de software. Algunos usos son Guía de instalación , Guía de introducción y varias guías prácticas . Un ejemplo es la Guía de introducción de Picasa . [5]
En algunas aplicaciones de software empresarial , donde los grupos de usuarios tienen acceso únicamente a un subconjunto de la funcionalidad completa de la aplicación, se puede preparar una guía del 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 .