improved diagrams.md :sunglasses: