add doc for add_states