Add diagrams to test Mermaid.js integration

[schlessera]

This PR adds a few diagrams to the docs to test whether the Mermaid.js integration in GitHub works as epxected.