updated docs with new global state keys