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/