[3.1.x] Refs #31034 -- Documented admin requires django.template.context_processors.request.

Required since d24ba1be7a.

Co-authored-by: Carlton Gibson <carlton.gibson@noumenal.es>

Backport of e341bed606 from master

docs/ref/contrib/admin/index.txt

@@ -34,11 +34,18 @@ If you're not using the default project template, here are the requirements:
 
 #. Configure a :class:`~django.template.backends.django.DjangoTemplates`
    backend in your :setting:`TEMPLATES` setting with
-   ``django.contrib.auth.context_processors.auth`` and
+   ``django.contrib.auth.context_processors.auth``,
+   ``django.contrib.messages.context_processors.request``, and
    ``django.contrib.messages.context_processors.messages`` in
    the ``'context_processors'`` option of :setting:`OPTIONS
    <TEMPLATES-OPTIONS>`.
 
+   .. versionchanged:: 3.1
+
+       ``django.contrib.messages.context_processors.request`` was added as a
+       requirement in the ``'context_processors'`` option to support the new
+       :attr:`.AdminSite.enable_nav_sidebar`.
+
 #. If you've customized the :setting:`MIDDLEWARE` setting,
    :class:`django.contrib.auth.middleware.AuthenticationMiddleware` and
    :class:`django.contrib.messages.middleware.MessageMiddleware` must be

docs/releases/3.1.txt

@@ -96,6 +96,11 @@ Minor features
   enabled by default but can be disabled by using a custom ``AdminSite`` and
   setting :attr:`.AdminSite.enable_nav_sidebar` to ``False``.
 
+  Rendering the sidebar requires access to the current request in order to set
+  CSS and ARIA role affordances. This requires using
+  ``'django.template.context_processors.request'`` in the
+  ``'context_processors'`` option of :setting:`OPTIONS <TEMPLATES-OPTIONS>`.
+
 * ``XRegExp`` is upgraded from version 2.0.0 to 3.2.0.
 
 * jQuery is upgraded from version 3.4.1 to 3.5.1.

docs/spelling_wordlist

@@ -6,6 +6,7 @@ admin
 admindocs
 admins
 affine
+affordances
 aggregator
 Ai
 Alchin