Documentación de Design System UX
Registro de patrones de interacción, componentes y decisiones de diseño basados en investigación.
Qué es
La Documentación de Design System UX registra los patrones de interacción, componentes y decisiones de diseño respaldadas por investigación con usuarios. Va más allá de una guía de estilo visual — documenta por qué cada patrón funciona, no solo cómo se ve.
Para qué sirve
Qué métodos lo alimentan
Cuándo hacerlo
Cuándo usarlo
Cuándo NO usarlo
Cómo se hace
Cómo hacerlo paso a paso
- 1Inventario de componentes: Lista todos los componentes y patrones existentes.
- 2Documenta decisiones: Para cada componente, registra: qué problema resuelve, cuándo usarlo, investigación que lo respalda.
- 3Define guidelines de uso: Documenta cuándo usar y cuándo NO usar cada componente.
- 4Incluye evidencia: Resultados de tests, datos de A/B testing, citas de usuarios.
- 5Crea plantillas: Templates para casos comunes que el equipo pueda reutilizar.
- 6Establece proceso de actualización: Define cómo se agregan, modifican o eliminan patrones.
Tips para equipos pequeños
Ejemplo contextualizado
Contexto: Plataforma SaaS de RRHH con equipo de 5 diseñadores.
Componente documentado — Modal de confirmación destructiva: Uso: cuando el usuario va a eliminar datos permanentemente. Patrón: fondo rojo, botón primario dice 'Eliminar [nombre]' (no solo 'Eliminar'), requiere escribir el nombre para confirmar. Investigación: test con 8 usuarios mostró que 'Eliminar' genérico causó 3 eliminaciones accidentales; pedir el nombre redujo accidentes a 0. Cuándo NO usar: para acciones reversibles (usar toast con 'Deshacer' en su lugar).