Cómo dibujar diagramas de arquitectura de software (2022)

• Artículo sobre cómo dibujar diagramas de arquitectura de software efectivos
• El autor enfatiza la importancia de los diagramas en el desarrollo de software, ya que a menudo se convierten en el centro de las discusiones y la toma de decisiones
• El contenido del diagrama debe ser preciso, estar actualizado y no ser ambiguo, y las entidades y relaciones deben representarse con exactitud
• El autor propone varias características de un diagrama efectivo:
  • Minimizar la distancia entre vecinos: mantener los nodos relacionados cerca unos de otros hace que el diagrama sea más fácil de entender. A medida que el diagrama crece, esto se vuelve un reto
  • Buscar simetría: los diagramas simétricos son estéticamente atractivos y fáciles de entender. Además, pueden reforzar el significado que transmite el diagrama
  • Alineación centrada: un diagrama limpio y alineado aclara los conceptos. Mantener la alineación con cada nueva incorporación ayuda a que el diagrama se vea ordenado
  • Usar grupos de contenedores: dividir el diagrama en varias áreas etiquetadas hace que sea más fácil de entender. Los contenedores pueden añadir contexto, mostrar abstracciones o agrupar objetos relacionados
• El autor promete tratar más en la parte 2 sobre el trazado de líneas, el tamaño y la posición de las etiquetas, los colores, los íconos y más
• Este artículo forma parte del blog de Terrastruct, que ofrece recursos para ingenieros y desarrolladores de software

[GN⁺]

Comentarios en Hacker News

• Un usuario disfruta crear diagramas por las opciones de formato y la sintaxis del lenguaje D2, y escribió una entrada de blog al respecto.
• VisualFlows.io planea lanzar pronto la v1.0, con la que los usuarios podrán diseñar en minutos un mapa animado de arquitectura de su SaaS. Entre sus funciones principales están Smart Sections, Smart Edges, Smart Node Deletion, modos oscuro/claro, embebible, arrastrar y soltar imágenes/svgs/gifs, íconos de AWS/Windows/Google y soporte para Markdown.
• Otro usuario sostiene que puede ser difícil mantener diagramas "bonitos" cuando el sistema empieza a cambiar, y propone usar diagrams-as-code como una alternativa más eficiente.
• Un usuario expresa su frustración porque, aunque los modelos de lenguaje grandes son posibles, no existe una herramienta local para reorganizar bloques y flechas con fines estéticos. Se pregunta por qué no hay una herramienta en la que el usuario pueda dibujar cajas y flechas y la herramienta alinee todo para que se vea bien.
• Un usuario traza una similitud entre los diagramas de arquitectura de software y los esquemas eléctricos, diagramas de circuitos y otros planos de ingeniería. Afirma que no existe una "respuesta correcta" y que elegir buenas abstracciones y formas de representación es lo que separa una idea comprensible de una confusión lamentable.
• Un usuario comparte su experiencia usando yEd para hacer diagramas. Con esta herramienta se pueden desordenar cajas y flechas, pero con unos cuantos clics en el menú todo se acomoda automáticamente.
• Un usuario agradece un artículo que explica de manera práctica cómo hacer que algo se vea más bonito. Dice que normalmente se guía por la intuición.
• Un usuario comparte su experiencia usando D2 para autogenerar un diagrama D2 grande a partir de un archivo serverless.yml. La herramienta se actualiza automáticamente a medida que el sistema crece.
• Otro usuario añade el lenguaje D2 a su entrada de blog para tratar el tema del código de diseño de ciberseguridad.
• Un usuario propone agregar bloques de plantuml para insertar diagramas en proyectos escritos como documentos Markdown. Señala que en GitLab se renderizan bien al visitar el archivo .md en el navegador web, pero que GitHub todavía no tiene esa función.