/* added a nice sequence diagram to indicate what it does */