[Django] #30253: Add a note that `nulls_first` or `nulls_last` can be set in `order_by` using an F expression.

[Django]

#30253: Add a note that `nulls_first` or `nulls_last` can be set in `order_by`
using an F expression.
-----------------------------------------+-------------------------------
Reporter: Paul Wayper | Owner: nobody
Type: New feature | Status: new
Component: Documentation | Version: 2.1
Severity: Normal | Keywords: documentation
Triage Stage: Unreviewed | Has patch: 0
Needs documentation: 0 | Needs tests: 0
Patch needs improvement: 0 | Easy pickings: 0
UI/UX: 0 |
-----------------------------------------+-------------------------------
While the `nulls_first` and `nulls_last` are documented in the F
expression documentation, this is not included in the documentation on the
`order_by` queryset method. It would be useful to include a note, and
possibly and example, in the `order_by` method to make it easier to find.

--
Ticket URL: <https://code.djangoproject.com/ticket/30253>
Django <https://code.djangoproject.com/>
The Web framework for perfectionists with deadlines.

[Django]

#30253: Add a note that `nulls_first` or `nulls_last` can be set in `order_by`
using an F expression.

-------------------------------+--------------------------------------

Reporter: Paul Wayper | Owner: nobody
Type: New feature | Status: new
Component: Documentation | Version: 2.1

Severity: Normal | Resolution:

Keywords: documentation | Triage Stage: Unreviewed
Has patch: 0 | Needs documentation: 0
Needs tests: 0 | Patch needs improvement: 0
Easy pickings: 0 | UI/UX: 0

-------------------------------+--------------------------------------

Comment (by Paul Wayper):

I've created this branch for a first draft of the documentation change:

https://github.com/django/django/pull/11083

Let me know what you think!

--
Ticket URL: <https://code.djangoproject.com/ticket/30253#comment:1>

[Django]

#30253: Document how to order nulls in QuerySet.order_by()
-------------------------------------+-------------------------------------

Reporter: Paul Wayper | Owner: nobody

Type: | Status: new
Cleanup/optimization |
Component: Documentation | Version: 2.1
Severity: Normal | Resolution:
Keywords: documentation | Triage Stage: Ready for
| checkin
Has patch: 1 | Needs documentation: 0

Needs tests: 0 | Patch needs improvement: 0
Easy pickings: 0 | UI/UX: 0

-------------------------------------+-------------------------------------
Changes (by Tim Graham):

* has_patch: 0 => 1
* type: New feature => Cleanup/optimization
* stage: Unreviewed => Ready for checkin

--
Ticket URL: <https://code.djangoproject.com/ticket/30253#comment:2>

[Django]

#30253: Document how to order nulls in QuerySet.order_by()
-------------------------------------+-------------------------------------

Reporter: Paul Wayper | Owner: nobody

Type: | Status: closed
Cleanup/optimization |
Component: Documentation | Version: 2.1
Severity: Normal | Resolution: fixed

Keywords: documentation | Triage Stage: Ready for
| checkin

Has patch: 1 | Needs documentation: 0

Needs tests: 0 | Patch needs improvement: 0
Easy pickings: 0 | UI/UX: 0

-------------------------------------+-------------------------------------
Changes (by Tim Graham <timograham@…>):

* status: new => closed
* resolution: => fixed

Comment:

In [changeset:"a48c0180f56316b0e32bf2f4a858d1e097eb1863" a48c018]:
{{{
#!CommitTicketReference repository=""
revision="a48c0180f56316b0e32bf2f4a858d1e097eb1863"
[2.2.x] Fixed #30253 -- Doc'd how to order nulls in QuerySet.order_by().

Backport of 1025e764291167f2f34a4d55bd3d043836e74250 from master.
}}}

--
Ticket URL: <https://code.djangoproject.com/ticket/30253#comment:3>

[Django]

#30253: Document how to order nulls in QuerySet.order_by()
-------------------------------------+-------------------------------------

Reporter: Paul Wayper | Owner: nobody

Type: | Status: closed
Cleanup/optimization |
Component: Documentation | Version: 2.1

Severity: Normal | Resolution: fixed
Keywords: documentation | Triage Stage: Ready for
| checkin

Has patch: 1 | Needs documentation: 0

Needs tests: 0 | Patch needs improvement: 0
Easy pickings: 0 | UI/UX: 0

-------------------------------------+-------------------------------------

Comment (by Tim Graham <timograham@…>):

In [changeset:"1025e764291167f2f34a4d55bd3d043836e74250" 1025e764]:
{{{
#!CommitTicketReference repository=""
revision="1025e764291167f2f34a4d55bd3d043836e74250"

Fixed #30253 -- Doc'd how to order nulls in QuerySet.order_by().
}}}

--
Ticket URL: <https://code.djangoproject.com/ticket/30253#comment:4>