cache: add some comments to document the cache subsystem

Signed-off-by: Sébastien Boisvert <boisvert@anl.gov>