id	summary	reporter	owner	description	type	status	component	version	severity	resolution	keywords	cc	stage	has_patch	needs_docs	needs_tests	needs_better_patch	easy	ui_ux
25444	Restructure expressions documentation to better highlight ORM support	Josh Smeaton	nobody	"The docs in docs/ref/models/expressions.txt could probably do with an overhaul. The original document was very specific about highlighting the use-cases of F expressions in terms of filter and update.

I think the docs should be structured in terms of which queryset methods support expressions. We can then leave the specific expression reference below.

Some of the F() examples can be pulled out into the queryset method sections, but the F() section can still highlight the things it is particularly good at -- like avoiding race conditions.

The docs would be structured like:

{{{
=================
Query Expressions
=================

Intro..

Supported QuerySet Operations
=========================

Not every :doc:`QuerySet </ref/models/queryset>` method has full support for
Query Expressions, but the support is growing with each release. Below is a
quick overview showing which methods do have support.

create() and update()
----------------------------------

Intro

Examples

filter() and exclude()
--------------------------------

Intro

Examples

}}}"	Cleanup/optimization	closed	Documentation	dev	Normal	invalid			Unreviewed	0	0	0	0	0	0