update outdated documentation around state