> - Why isn't diagram generation automated as part of the build process (UML or otherwise)? This is very hard. And since it's hard, it's not automated. And sin

> - Why isn't diagram generation automated as part of the build process (UML or otherwise)? This is very hard. And since it's hard, it's not automated. And since it's not automated, it goes out of date very quickly. I think that's the fundamental issue: keeping around evergreen documentation is a lot of overhead. There is no connection between the code and the diagrams, so it's too easy to change the code and not realize that the diagram needs to be updated too. Another thing is that it's really the most useful for new members. If you've been working on the infra for a while, you already know the structure and you don't need the diagram. So teams tend to just avoid the diagrams altogether.