On the one hand, diagrams are easy to update, track changes, and show in different contexts.
On the other, a lot of automated diagrams are unclear because they miss important aspects of layout.
I believe you should start manual, and switch to code-based when it becomes painful to keep updating it.
That said, I don’t know why I’d do it in a bespoke system, as this article shows. That seems like the worst of both worlds.
On the one hand, diagrams are easy to update, track changes, and show in different contexts.
On the other, a lot of automated diagrams are unclear because they miss important aspects of layout.
I believe you should start manual, and switch to code-based when it becomes painful to keep updating it.
That said, I don’t know why I’d do it in a bespoke system, as this article shows. That seems like the worst of both worlds.