"readme rewritten"
sequence diagrams added in
merge