Add documentation on altering states.