added more comments to the state definitions