Fixed #26290 -- Documented that a QuerySet for pagination should be ordered.

1 files changed, 5 insertions, 2 deletions

diff --git a/docs/topics/pagination.txt b/docs/topics/pagination.txt
index 7fb31324fb..a45b8fabd6 100644
--- a/docs/topics/pagination.txt
+++ b/docs/topics/pagination.txt
@@ -140,8 +140,11 @@ Required arguments
 ------------------
 
 ``object_list``
-    A list, tuple, Django ``QuerySet``, or other sliceable object with a
-    ``count()`` or ``__len__()`` method.
+    A list, tuple, ``QuerySet``, or other sliceable object with a ``count()``
+    or ``__len__()`` method. For consistent pagination, ``QuerySet``\s should
+    be ordered, e.g. with an :meth:`~django.db.models.query.QuerySet.order_by`
+    clause or with a default :attr:`~django.db.models.Options.ordering` on the
+    model.
 
 ``per_page``
     The maximum number of items to include on a page, not including orphans