improvements to caching documentation