better cache documentation

[muametgrooby]

I think documentation around cache can be greatly improved, I had a few questions when I was reading docs for the first time and docs did not answer them

1. How does .cache() work on objects
2. Is cache enabled by default and what are the defaults
3. how do I use it