adding info about the caching to the docs