update docs on states