> I'm very skeptical of "diagrams as code" because it seems like the goal is to minimize effort, not to produce a useful diagram. It is, and this is a valid go

> I'm very skeptical of "diagrams as code" because it seems like the goal is to minimize effort, not to produce a useful diagram. It is, and this is a valid goal. The ideal you're chasing doesn't happen in most projects: minimising efforts means those projects are much more likely to have an up-to-date diagram of some description.