added state documentation