add more comments..
add flows.pdf which contains the abstraction of how it works, which messages are sent during each phase