update docs to reflect reality