clarify roles in state transition diagram (#18)