Commit 0dc3822f authored by Duane Hilton's avatar Duane Hilton Committed by Tim Graham
Browse files

[1.9.x] Fixed #26290 -- Documented that a QuerySet for pagination should be ordered.

Backport of f8b23e52 from master
parent c6424efb
Loading
Loading
Loading
Loading
+5 −2
Original line number Diff line number Diff line
@@ -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