Ticket #9709: django-admin-and-caching-docs.patch

docs/faq/admin.txt

@@ -31 +31 @@
 How can I prevent the cache middleware from caching the admin site?
 -------------------------------------------------------------------
 
-Set the :setting:`CACHE_MIDDLEWARE_ANONYMOUS_ONLY` setting to ``True``. See the
-:ref:`cache documentation <topics-cache>` for more information.
+See :ref:`AdminSite and caching <admin-and-caching>` documentation.
 
 How do I automatically set a field's value to the user who last edited the object in the admin?
 -----------------------------------------------------------------------------------------------

docs/ref/contrib/admin.txt

@@ -1071 +1071 @@
         ('^basic-admin/(.*)', basic_site.root),
         ('^advanced-admin/(.*)', advanced_site.root),
     )
+
+.. _admin-and-caching:
+
+``AdminSite`` and ``caching``
+=============================
+
+``AdminSite`` is a set of pages which you probably do not want to cache at all. There
+are two simple ways to exclude them.
+
+If only a small fraction of your traffic is generated by authenticated users, you may just
+set the :setting:`CACHE_MIDDLEWARE_ANONYMOUS_ONLY`setting to ``True``.
+See the :ref:`cache documentation <topics-cache>` for more information.
+
+Other solution is to tell Django not to cache the whole admin subtree, using decorator at
+URLs configuration::
+
+    # urls.py
+    from django.conf.urls.defaults import *
+    from django.contrib import admin
+    from django.views.decorators.cache import never_cache
+
+    admin.autodiscover()
+
+    urlpatterns = patterns('',
+        ('^admin/(.*)', never_cache(admin.site.root)),
+    )
+