Hopefully you will find this useful.Īlright, so lets dive in. I find these simple animated slides with arrows really helps to drive attention to what you are chatting about. I also wanted to share how I create some of these animations to help give life to an architecture diagram. So, I wanted to walk through a few of the techniques I use for creating these. Personally, I find having even a simple high-level diagram can help explain your point of view, and it helps give context to your technical documents. Here’s what works for me.Ĭhances are, if you are working as a Sysadmin or in some Ops related role, you are likely doing a fair amount of technical writing. Often times you need to write technical documentation, or share knowledge with other team members, and having an architecture diagram can really help. In this episode, I wanted to share a few tips for how I create architecture diagrams. GCP Official Icons and Solution Architectures.Access and learning curve for those who need to use the tool.Support for standards and diagram types you wish to use.Open source license and team maintaining the project.There are many diagrams as code tools to choose from, and it’s important to consider which is best suited for your use case. Graphviz is a graph visualization software for representing structural information as diagrams.īest for developers trying to visualize large and complex graph-based information from code. Generic technology and programming-related icons.AWS, Azure, GCP, OpenStack, K8S and DigitalOcean icons.Diagram sequences to show use cases within diagramsĭiagrams allow you to draw cloud system architectures using Python code.īest for developers who want to draw diagrams using popular cloud provider icons and styles quickly.Dynamic layout to change diagrams depending on perspective.Ilograph allows interactive diagrams to be drawn using YAML with auto layout, changing the view when you want to see different perspectives.īest for semi-technical people who want a web-based solution for visualizing diagrams written as code. User journey, Gantt and requirement diagrams.Flowchart, sequence, class, state and entity relationship diagrams.Mermaid.js is an easy-to-use JavaScript-based diagramming and charting tool.īest for developers who want quickly create a range of diagram types and use GitHub to consume them. SQL tables, classes and sequence diagrams.Sequence, use-case, class, object and activity diagrams.ĭ2 from Terrastruct is a diagram scripting language that turns text into diagrams.īest for developers who want to create flexible diagrams in code with auto-layout functionality.PlantUML is a tool that allows you to write diagrams such as sequence, object, component, usecase, class diagrams and more.īest for technical people who want the flexibility of creating many different diagram types and checking them into source control. Architectural Decision Records in a documentation tool.Stored in source control to be where the engineering team is.Diagrams as code to draw diagrams using the Structurizr DSL.Structurizr builds upon "diagrams as code", allowing you to create multiple diagrams from a single model using a number of tools and programming languages.įree and open source with a paid web platform.īest for technical people who want to use the C4 model with a DSL and check it into source control. These tools often include auto-layout capabilities for automatically drawing diagrams. Clear system designs give engineering teams an enhanced understanding of the architecture and plan for future development whilst identifying potential issues.ĭiagrams as code involve writing your model objects, relationships and diagrams using a markup language which can be checked into source control. Diagrams as code tools are suited for long-term documentation as they can be checked into source control with version history.ĭiagramming software architecture provides several benefits to how we communicate complexity.Software architecture tools can be categorized into three groups, modelling tools, diagrams as code and diagramming tools.
0 Comments
Leave a Reply. |
AuthorWrite something about yourself. No need to be fancy, just an overview. ArchivesCategories |