state machine discussion in README