Borrador editorial publicado para consulta. La revisión factual y lingüística está pendiente. Los ejemplos son ilustrativos.
Define cuándo se usa
Para cada componente, explica su función, contexto y casos donde no corresponde. Una tarjeta de servicio y una alerta pueden compartir bordes, pero comunican cosas distintas. Añade ejemplos con contenido real. Evita una biblioteca que solo muestra formas vacías: quien construya una página necesita saber qué decisión del usuario apoya cada pieza y cómo encaja con otras.
Incluye variantes y comportamiento
Documenta estados de carga, error, deshabilitado, foco y contenido largo cuando existan. Define qué parte puede cambiar y qué debe permanecer consistente. Incluye idiomas y tamaños de pantalla representativos. Si una variante requiere otra lógica, explícalo; no conviertas diferencias funcionales en simples opciones visuales que alguien pueda combinar de una manera que contradiga el flujo.
Prueba una reutilización independiente
Ejemplo: otra persona crea una tarjeta de nuevo servicio siguiendo la documentación, sin copiar una página completa. Verifica que precio, unidad, enlace y estado siguen claros con un título largo. La biblioteca se acepta cuando permite producir una instancia correcta y detectar una combinación inválida, además de identificar la versión y a quién consultar cuando cambie el contrato del componente.
Puntos clave
- Documenta decisiones y estados para que reutilizar un componente conserve su significado.