On: Design structured diagrams, built to increase your...

[aliswe]

Eventually your docs will be updated and noone will be around to update the included diagrams. And when the users (the developers!) notice the discrepancy, trust will decrease.