Ayuda y Documentación

Resumen

Aunque es mejor si el sistema puede usarse sin documentación, puede ser necesario proporcionar ayuda y documentación. Esta información debe ser fácil de buscar, enfocada en la tarea del usuario, listar pasos concretos a seguir, y no ser demasiado extensa.

Origen

Autor: Jakob Nielsen
Año: 1994 (refinado 2020)
Fuente: Nielsen Norman Group - "10 Usability Heuristics for User Interface Design"

Fundamento Psicológico

Los usuarios acceden a la ayuda en momentos de frustración o bloqueo (help-seeking behavior). La documentación efectiva debe minimizar la carga cognitiva adicional y resolver el problema rápidamente. El modelo de aprendizaje situado indica que la ayuda contextual es más efectiva que manuales genéricos.

Aplicación en Diseño

Ayuda Contextual

Tooltips informativos en elementos complejos
Hints inline en formularios
Botones de "?" junto a funciones avanzadas
Onboarding tours para nuevas features

Documentación Estructurada

Búsqueda efectiva en docs
Categorización por tareas, no por features
Ejemplos y casos de uso concretos
Videos y GIFs para procesos complejos

Accesibilidad de la Ayuda

Accesible desde cualquier punto (F1, "?")
No bloquear la tarea actual al buscar ayuda
Quick start guides para empezar rápido
FAQs para problemas comunes

Formato Efectivo

Pasos numerados y concretos
Screenshots actualizados
Texto escaneable (headers, bullets)
Longitud apropiada (ni muy corto ni muy extenso)

Ejemplos

Notion: Help overlay contextual con search
Figma: Interactive tutorials integrados
Stripe Docs: Código ejecutable en la documentación
Slack: Tips del día y onboarding progresivo
GitHub: Guides paso a paso con screenshots

Anti-patterns

❌ Manuales PDF de 200 páginas sin índice
❌ Ayuda que requiere salir de la aplicación
❌ Documentación desactualizada
❌ Solo FAQs sin documentación estructurada
❌ Chatbots que no resuelven problemas reales

Métricas

Help Seeking Frequency: Qué tan seguido los usuarios buscan ayuda
Help Success Rate: % que resuelve su problema con docs
Time in Documentation: Tiempo hasta encontrar respuesta
Search Success Rate: % de búsquedas exitosas en docs

Principios Relacionados

[[progressive-disclosure]] - Revelar complejidad gradualmente
[[nielsen-recognition-recall]] - Información visible cuando se necesita
[[nielsen-match-real-world]] - Lenguaje del usuario

Referencias

Nielsen, J. (1994). "Usability Engineering". Morgan Kaufmann
Lave, J. & Wenger, E. (1991). "Situated Learning". Cambridge University Press
https://www.nngroup.com/articles/help-and-documentation/