corrected doc of state transition and added some info