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
29940	"Update ""Performing raw SQL queries"" doc to recommend not using raw()"	Katie McLaughlin	nobody	"The documentation on this page is 5-10 years old and doesn't reflect the current state of the ORM, where there shouldn't be a reason to drop to raw() SQL any more, given annotations, aggregation, explain plans and custom query expressions. 

It should be updated to have above the fold: ""Don't do this"". But until `raw()` is completely removed, the page should detail how to do it. 

I'll submit a PR to do just this, but I would appreciate a second opinion on how best to word/present this. 


https://docs.djangoproject.com/en/2.1/topics/db/sql/

Reference talk: https://youtu.be/p9Bgr5VOISo?t=1433"	Cleanup/optimization	closed	Documentation	2.1	Normal	fixed			Accepted	1	0	0	1	0	0