updating diagrams and docs