updates the state machine docs based on Sascha's reviews
Merge branch 'master' of github.com:mbeddr/mbeddr.core