update docs to reflect current reality