add documentation diagrams

[rapenne-s]

The purpose of this PR is to add some diagrams to Nix documentation.

This is still draft work and I'll close #7041 and #7042. I'm not sure about the content and the place to put them. Ultimately, they will be committed as ascii diagrams and not using mermaid.