added documentation about state machine events

added a new page to the state machine documentationabout its events