Etiquetas: Diseño · Equipos
Una guía de estilo que el equipo realmente usa
Las guías mueren cuando viven en un PDF. Lo que funcionó para nosotros: reglas cortas, ejemplos vivos y un lugar único donde cambiarlas.
Martín Cabrera · · 2 min de lectura
Todo equipo empieza con la misma intención: escribir una guía de estilo y que todos la sigan. Seis meses después, la guía es un documento que nadie abre y las pantallas se parecen cada vez menos entre sí.
Por qué mueren las guías
Una guía muere cuando cambiarla cuesta más que ignorarla. Si para ajustar un color hay que editar un PDF, avisar por tres canales y esperar una reunión, la gente ajusta el color en su pantalla y sigue.
La regla que no se puede probar es una sugerencia.
Reglas cortas, con un porqué
Escribimos cada regla en una línea y le pusimos al lado la razón. «Un solo botón primario por pantalla» es fácil de recordar; «porque dos acentos compiten y nadie sabe qué hacer primero» es lo que convence.
- Una regla por línea, en imperativo.
- Siempre con su razón entre paréntesis.
- Un ejemplo vivo al lado, no una captura.
- Un test cuando la regla se puede medir.
Un solo lugar para cambiarlas
La guía vive en el mismo repositorio que el código. Cambiar una regla es un pull request: se discute, se aprueba y llega a todos con la próxima versión. Lo que no está en el repositorio no existe.