/**
* A central location for static variable storage.
- *
+ * @var array
* @code
* `Civi::$statics[__CLASS__]['foo'] = 'bar';
* @endcode
* The name of the cache. The 'default' cache is biased toward
* high-performance caches (eg memcache/redis/apc) when
* available and falls back to single-request (static) caching.
+ * Ex: 'short' or 'default' is useful for high-speed, short-lived cache data.
+ * This is appropriate if you believe that latency (millisecond-level
+ * read time) is the main factor. For example: caching data from
+ * a couple SQL queries.
+ * Ex: 'long' can be useful for longer-lived cache data. It's appropriate if
+ * you believe that longevity (e.g. surviving for several hours or a day)
+ * is more important than millisecond-level access time. For example:
+ * caching the result of a simple metadata-query.
+ *
* @return CRM_Utils_Cache_Interface
* NOTE: Beginning in CiviCRM v5.4, the cache instance complies with
* PSR-16 (\Psr\SimpleCache\CacheInterface).