diff --git a/docs/db-api.txt b/docs/db-api.txt index 038cdc8613c..5ce0aa01e7e 100644 --- a/docs/db-api.txt +++ b/docs/db-api.txt @@ -511,6 +511,9 @@ like so:: Entry.objects.order_by('?') +Note: ``order_by('?')`` queries may be expensive and slow, depending on the +database backend you're using. + To order by a field in a different table, add the other table's name and a dot, like so::