I'm really not comfortable going deep into caching semantics as people's first introduction to the feature. If anything, these should be in the API docs or an advanced guide.