Escribe la documentación de un sistema de diseño y mantenla al día
Úsalo para documentar el sistema de diseño de tu equipo. Define qué cubrir, divide el trabajo en páginas por prioridad, explica cada componente con qué, por qué, cuándo y cómo, y antes de publicar comprueba que documentos, diseño y código coinciden.
Para usar estas reglas de IA
## Decide qué cubre la documentación, de los principios a los componentes
Documente tanto los fundamentos intangibles del sistema —principios, decisiones y formas de trabajo— como sus activos tangibles: patrones, componentes, reglas de uso y herramientas de implementación. Haga visible el alcance antes de redactar, para que las omisiones se conviertan en elementos del trabajo pendiente en lugar de sorpresas.
## Divide la documentación en páginas y empieza por lo que más cuesta
Divida el trabajo en páginas autónomas. Dé prioridad a las áreas que causan más fricción y después a los componentes de uso frecuente o con muchas dependencias. Lleve un seguimiento del progreso y revise las prioridades a medida que cambien las restricciones. Use cualquier herramienta que el equipo pueda mantener y en la que pueda buscar y compartir información de manera fiable.
## Explica cada componente respondiendo a cuatro preguntas
Para cada componente, responda a cuatro preguntas: ¿Qué es, incluidos sus estados y opciones? ¿Por qué elegirlo frente a alternativas similares? ¿Cuándo resulta adecuado en su contexto? ¿Cómo debe utilizarse, incluidas las variaciones admitidas, los ejemplos y las indicaciones explícitas sobre lo que se debe y no se debe hacer?
## Escribe primero para diseñadores y desarrolladores, y resume para los demás
Atienda primero a diseñadores y desarrolladores con comportamientos claros, criterios de decisión, referencias de implementación y enlaces al código o a las historias de componentes. Ofrezca a los roles de producto, control de calidad e investigación una vía de verificación más breve. Reutilice patrones sólidos de otros sistemas, pero adáptelos; el acceso funcional importa más que la perfección visual.
## Antes de publicar, comprueba que documentación, diseño y código coinciden
Trate la documentación como un producto vivo. Revise los componentes y las directrices nuevos durante las sesiones de revisión crítica, evalúe las necesidades de documentación al inicio del proyecto, pruebe los componentes con usuarios y mediante comprobaciones de accesibilidad, y verifique la alineación entre diseño, código y documentación antes del lanzamiento. Cambie los rituales de mantenimiento cuando la evidencia demuestre que no funcionan.