{
  "id": 10080926,
  "title": "Diagrams as Code: Keep Your Architecture Docs Alive Inside the Repo",
  "url": "https://urgent.news/2026/09/26/diagrams-as-code-keep-your-architecture-docs-alive-inside-the-repo",
  "topic": "tech",
  "section": "Tech",
  "published": "2026-09-26T22:42:57.000Z",
  "source": {
    "name": "Dev.to",
    "slug": "dev-to",
    "url": "https://dev.to/eme_gug_0821b41b948be6516/diagrams-as-code-keep-your-architecture-docs-alive-inside-the-repo-40co"
  },
  "original_language": "en",
  "account": "Diagramas de código são uma solução que permite que as definições de arquitetura sejam mantidas junto ao código-fonte, podendo ser revisadas através de Pull Requests e nunca ficar obsoleta. Ao contrário de diagramas em imagem, os diagramas de código são textuais, portanto podem ser versionados, revisados e executados automaticamente. O uso de diagramas de código também elimina a necessidade de usar ferramentas externas para editar ou renderizar os diagramas, o que acelera o processo de revisão e reduz aprobção de alterações.\n\nUm dos principais benefícios de usar diagramas de código é a facilidade com que os desenvolvedores podem atualizar conteúdos relacionados à arquitetura do sistema. Ao incorporar as definições de diagramas diretamente no repositório do projeto, as alterações causadas por mudanças de código também são refletidas nos diagramas, permitindo assim uma visão completa das dependências e do fluxo de dados.\n\nUma das maneiras mais populares de criar diagramas de código é usando Mermaid, uma linguagem de diagramas que pode ser renderizada nativamente por plataformas como GitHub e GitLab. Além disso, outras linguagens de diagramas como PlantUML e Structurizr DSL também podem ser utilizadas, dependendo das necessidades específicas da equipe.\n\nPara integrar diagramas de código em um workflow de desenvolvimento, é recomendado adicionar as definições de diagramas em arquivos com a extensão .mmd e incluir um processo de validação durante a fase de CI/CD. Isso garante que todos os diagramas sejam revisados e validados antes de serem integrados ao código principal. Além disso, os diagramas podem ser gerados automaticamente a partir de informações disponíveis no código, como arquivos de configuração do Docker Compose ou scripts de build, garantindo que a arquitetura permaneça sincronizada com o código fonte.",
  "summary": "Bạn còn nhớ lần gần nhất mở file architecture.png trong thư mục docs/ không? Nếu team bạn giống phần lớn team mình từng làm thì file đó được vẽ bằng draw.io từ hai năm trước. Người vẽ đã nghỉ việc, file .drawio gốc cũng không ai tìm thấy, còn trong hình vẫn có một service đã bị xoá từ ba sprint trước. Tuần này trên Hacker News có hai dự án về vẽ diagram lên top là Reladraw (một ngôn ngữ diagram…",
  "key_points": [],
  "editors_take": null,
  "illustration": null,
  "coverage": {
    "outlets": 1,
    "also_reported_by": []
  },
  "ai_generated": true,
  "disclaimer": "Summaries, key points and the editor’s take are written by software from other outlets’ reporting and may contain errors — always check the linked original."
}