Django/django
11
0
Fork 0
Code Pull Requests Projects Releases Activity

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

Browse Source 
Backport of f8b23e52e86307428da2cf928bf4f1d9fdbd2694 from master
This commit is contained in:
Duane Hilton 2016-03-14 20:40:02 -06:00 committed by Tim Graham
parent c6424efbc6
commit 0dc3822f56
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