added notice/documentation about the first state being the entry state