clean up docs; improve Caching doc