           (cache-size (c/context->cache context cache-key)))))
 
 (defn- transform-and-cache
-  "TODO"
+  "Takes existing revision format maps missing the target format, generates the format XML, and returns
+   concepts with the requested format. Updates the cache with the generated XML."
   [context revision-format-maps target-format]
   (let [[t1 updated-revision-format-maps] (u/time-execution
                                            (u/fast-map #(rfm/add-additional-format context target-format %)

           [cmr.metadata-db.services.concept-service :as metadata-db]
           [cmr.umm-spec.core :as umm-spec]))

;; TODO add ability to get sizes in bytes of this cache
;; TODO test by downloading all the metadata as native from ops and then see how much memory caching
;; all of it actually takes


(ns cmr.search.data.metadata-retrieval.metadata-cache
  "Defines a cache for catalog item metadata. It currently only stores collections.

  The metadata cache contains data like the following:

  concept-id -> revision-format-map
                 * concept-id
                 * revision-id
                 * native-format - A key or map of format and version identifying the native format
                 * various format keys each mapped to a gzip bytes of compressed metadata."
  (require [cmr.common.util :as u]
           [cmr.common.cache :as c]
           [cmr.common.jobs :refer [defjob]]
