Some more javadoc
added sequence chart