innov
/
django1
1
0
Fork 0
Code Issues Pull Requests 1 Projects Releases Wiki Activity

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

This commit is contained in:
Duane Hilton 2016-03-14 20:40:02 -06:00 committed by Tim Graham
parent 1cb65b8a77
commit f8b23e52e8
1 changed files with 5 additions and 2 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

7
docs/topics/pagination.txt
View File

@ -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