docs and diagrams