updated docs and diagrams