Add docs / illustrations to the README which show how all the pieces fit together

[thisandagain]

This is a common request from partners and would be good to generate.

[thisandagain]

@carljbowman Could you share the architecture diagrams that you made out of my whiteboard scribbles? :-)