add comments
example code for the mean caching functions