No sé si la mayoría se beneficia tanto como yo de los diagramas que nos ayudan a entender procesos y flujos.

Creo que es importante trabajar en ellos en distintos momentos

• Antes que todo, al principio, en diagramas de flujo (lógica de negocio): Estos diagramas no deberían perder vigencia.
• Antes o mientras desarrollamos, con diagramas de sistema generales que nos ayuden a visualizar flujos técnicos
• Durante desarrollo o al final: Diagramas de secuencia que iliustren detalles de ciertos partes criticas del flujo, o no obvias, que hubo que implementar.

Acá dejo algunas practicas y herramientas actuales que parecen ser interesantes. Sobre todo me gusta mermaid

• gofore.com/en/generating-documentation-as-c..

Y para VsCode:

• marketplace.visualstudio.com/items?itemName..
• marketplace.visualstudio.com/items?itemName..

Video:

• Uso de Mermaid en Gitlab

Libs

• dev.to/simonbrown/software-architecture-dia..
• github.com/structurizr/cli

Docs

• c4model.com/#ContainerDiagram