diff --git a/docs/ref/middleware.txt b/docs/ref/middleware.txt
index 0ce4177e00..b542aee6e2 100644
--- a/docs/ref/middleware.txt
+++ b/docs/ref/middleware.txt
@@ -93,8 +93,8 @@ GZip middleware
 Compresses content for browsers that understand GZip compression (all modern
 browsers).
 
-It is suggested to place this first in the middleware list, so that the
-compression of the response content is the last thing that happens.
+This middleware should be placed before any other middleware that need to
+read or write the response body so that compression happens afterward.
 
 It will NOT compress content if any of the following are true: