Note: This post integrates several automation tools at once. My objective is to provide some well-documented, concrete examples of executable Ansible Playbooks, D2 Diagrams, and best practice to illustrate ways to make good documentation easy. Note: All code examples in this blog post are structured in a format to be …

Read More

Let's do something a bit more stereotypical when we talk about IT diagramming - building Network Diagrams with D2. D2's OSS layout engines (Dagre, ELK) are both centered around hierarchical layouts, which was a bit part of why we needed to hack D2 to get vSphere diagrams to draw. Here, it quickly becomes our best …

Read More

In a previous post we tested methods to illustrate documentation as-code with Terrastruct's D2 language. Documentation is good for infrastructure engineers in a variety of scenarios practically speaking, but we often forget the value of building consumer confidence. This may vary based on culture! My experiences are …

Read More

Documentation is always important, but always takes too much time Ever had an issue where a new installation is completed, but there's just no time to update the ol' Visio diagrams? Manually composed diagrams always possess a certain art to them, but the hours per unit of documentation isn't always worthwhile …

Read More