update docs to reflect cachiness.