Thank you for the feedback! Since I took over maintenance of
core.cache I will admit that I have not spent a lot of time on the docs. Given the Clojurists Together funding for 2023, I'll set aside some time to completely overhaul the docs for this library.
clojure.core.cache.wrapped extensively at work, because it is so much more convenient than trying to work with
clojure.core.cache and managing the atoms etc yourself. I need to distil that experience and make sure the docs reflect that.