update docs for caching changes