document Batman.StateMachine
Merge pull request #965 from rmosolgo/rm/state-machine-docs

document Batman.StateMachine