Please document .data/$.data caching

Please document .data/$.data caching

Neither the $.data nor the .data() documentation mention the cache system.
I was retrieving objects using .data, and then setting a value in the object.
Subsequent calls to .data didn't return the original object but the modified version.
I had no idea there was a cache, it was very confusing.