diff --git a/docs/ref/models/querysets.txt b/docs/ref/models/querysets.txt index 7ffc54e9dae..677d07be250 100644 --- a/docs/ref/models/querysets.txt +++ b/docs/ref/models/querysets.txt @@ -393,6 +393,11 @@ You can tell if a query is ordered or not by checking the :attr:`.QuerySet.ordered` attribute, which will be ``True`` if the ``QuerySet`` has been ordered in any way. +Each ``order_by()`` call will clear any previous ordering. For example, this +query will be ordered by ``pub_date`` and not ``headline``:: + + Entry.objects.order_by('headline').order_by('pub_date') + .. warning:: Ordering is not a free operation. Each field you add to the ordering