document the cache events