Browse Source

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

Duane Hilton 9 years ago
parent
commit
f8b23e52e8
1 changed files with 5 additions and 2 deletions
  1. 5 2
      docs/topics/pagination.txt

+ 5 - 2
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