update docs to be truer