updated docs for state parameter