add new fsm docs and readme