Diagramas en texto versionado frente a dibujos sueltos

Un diagrama escrito como texto en un repositorio se comporta como el código: cada cambio queda en un historial con autor, fecha y motivo; se puede comparar línea a línea qué se añadió y qué se quitó; pasa por la misma revisión que cualquier otro cambio; y la imagen se genera desde el texto, así que no hay dos versiones que divergen. Además, una herramienta puede leerlo y compararlo con el inventario.

Un dibujo suelto (una imagen exportada de una herramienta de dibujo) no tiene nada de eso: no se sabe quién lo cambió ni cuándo, no se puede comparar con la versión anterior y su fuente editable suele vivir en el portátil de alguien. El texto tampoco es mágico: un diagrama con niveles de detalle (contexto, piezas desplegables, módulos internos) sigue necesitando a alguien que lo mantenga.

La ventaja más inmediata del texto versionado es que un cambio se lee como una diferencia: las líneas que entran y las que salen. Quien revisa no tiene que comparar dos imágenes a ojo; ve exactamente qué flecha nueva aparece y qué dice que viaja por ella. Ahí se pesca lo que el motivo declarado del cambio no cuenta.

Abre el laboratorio, lee la notación en diagramas/convenciones.txt y después el cambio en revisión de la carpeta cambios-propuestos.

Un repositorio no garantiza nada por sí solo: la regla de Maconda es que todo cambio lo apruebe alguien distinto de quien lo escribe, y el historial es lo que permite comprobar si se cumplió. Un cambio fusionado sin revisor es un diagrama que dice lo que una sola persona quiso que dijera.

Lee el historial de cambios aceptados.

El problema de los dibujos sueltos no es estético: es que se siguen usando. El comité de junio de 2027 vio un dibujo de agosto de 2026, con su fuente perdida, mientras el texto del repositorio ya había cambiado varias veces. Lo que el comité decidió, lo decidió sobre una plataforma que ya no existía.

Compara los nodos del diagrama de despliegue vigente con las cajas del dibujo que se presentó al comité, según el índice de la carpeta compartida.

Cuando un equipo pasa a diagramas en texto, los dibujos sueltos no desaparecen solos. Si se dejan como están, alguien los volverá a pegar en una presentación; si se borran sin más, se pierde la historia de cómo era la plataforma. La salida habitual es marcarlos como históricos y que toda imagen nueva salga del texto.

Mira el índice de la carpeta compartida: dos de los tres dibujos no tienen fuente editable y uno se usó hace poco.