updating the diagrams
working on spec