Let’s put it simply: we’re overthinking our diagrams.
Creating diagrams is an important part of the code documentation process. Unfortunately, it’s usually seen as an arduous and time-consuming chore. Diagrams quickly become too granular and too detailed. The most important details are lost in a sea of complexity.