From f8b23e52e86307428da2cf928bf4f1d9fdbd2694 Mon Sep 17 00:00:00 2001
From: Duane Hilton <duane9@gmail.com>
Date: Mon, 14 Mar 2016 20:40:02 -0600
Subject: [PATCH] Fixed #26290 -- Documented that a QuerySet for pagination
should be ordered.
---
docs/topics/pagination.txt | 7 +++++--
1 file 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