update docs for potential behavior