Commit b9d9ab23 authored by Tim Graham's avatar Tim Graham
Browse files

Refs #24462 -- Emphasized that order_by() clears previous ordering.

parent e8a758e9

docs/ref/models/querysets.txt

+5 −0
Original line number Diff line number Diff line
@@ -388,6 +388,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