diagrams and readme update