Accuracy

Drift

The diagrams are out of date


source

  1. Input is inherently manual.
  2. Code tends to evolve separately to documentation.

Abstraction

Diagrams tend to be an abstraction over the detail. That's okay!