fixing readme fsm description and making sure comments are appropriate