Ticket #16785: docs-misc-design-philosophies-cache.patch

docs/misc/design-philosophies.txt

@@ -310 +310 @@
 
 GET and POST are distinct; developers should explicitly use one or the other.
 The framework should make it easy to distinguish between GET and POST data.
+
+Cache
+=====
+
+The core goals of a cache are:
+
+Less code
+---------
+
+A cache should be as fast as possible.  Hence, all framework code surrounding
+the cache backend should be kept to the absolute minimum, especially for
+``get()`` operations.
+
+Consistency
+-----------
+
+The cache backend should implement an interface consistent across the
+currently-supported cache backends.
+
+Extensibility
+-------------
+
+The cache API should be extensible at the application level based on the
+developer's needs (see :ref:`Cache Key Transformation
+<cache_key_transformation>`).
+
+Explicit is better than implicit
+--------------------------------
+
+In addition to incurring processing costs, magically resolving a potentially
+invalid key in the framework may obscure issues with the cache backend, making
+development more difficult.