updated two diagrams and added some text