Fixed #28786 -- Doc'd middleware ordering considerations due to CommonMiddleware setting Content-Length.

1 files changed, 4 insertions, 0 deletions

diff --git a/docs/ref/middleware.txt b/docs/ref/middleware.txt
index cfa6a77665..35407493f7 100644
--- a/docs/ref/middleware.txt
+++ b/docs/ref/middleware.txt
@@ -471,6 +471,10 @@ Here are some hints about the ordering of various Django middleware classes:
 
 #. :class:`~django.middleware.common.CommonMiddleware`
 
+   Before any middleware that may change the response (it sets the
+   ``Content-Length`` header). A middleware that appears before
+   ``CommonMiddleware`` and changes the response must reset ``Content-Length``.
+
    Close to the top: it redirects when :setting:`APPEND_SLASH` or
    :setting:`PREPEND_WWW` are set to ``True``.