Mermaid: Easier and more contextualized documentation

[erelling]

Not being a frontend developer, I sometimes find the documentation is geared towards a skillset I haven't got.

I find mermaid to be an amazing tool but often find I need a bit more context and getting-started hints.

[klemmchr]

Thanks for your issue. It would be awesome if you could enhance the docs so they provide more value from a beginners perspective. You self assigned this issue, so I assume you want to work it out?

[erelling]

Yes, will do!

[klemmchr]

Awesome! Make sure to have a look at our contributing guidelines.