Automatically generated diagrams seem to be the dream for many of the developers we chat to, however we don't see this working as great as they believe. This is due to "the model code gap" which is where the abstractions we use to discuss software architecture rarely matches 1:1 with the source code. You can read more about this on our blog article below.
We think this is more of a human/organizational problem rather than a technical one and we have tons of ideas about how to use links to reality to help humans keep docs up to date. For example an object which has had a lot of commit history recently probably needs the diagrams or docs updating.
https://blog.icepanel.io/2022/11/30/the-model-code-gap
We think this is more of a human/organizational problem rather than a technical one and we have tons of ideas about how to use links to reality to help humans keep docs up to date. For example an object which has had a lot of commit history recently probably needs the diagrams or docs updating.