New comments and diagrams

Last comments made together over skype
And updated diagrams