Attempt to fix the caching documentation

Did I get it right?