document the state variable

hopefully correctly