From f8b23e52e86307428da2cf928bf4f1d9fdbd2694 Mon Sep 17 00:00:00 2001 From: Duane Hilton 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