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
27587	Document str(QuerySet.query)	Peter Inglesby	JosiahDub	"As far as I can tell, the only place where the behaviour of `str(QuerySet.query)` is mentioned in the docs is as a throwaway comment in [https://docs.djangoproject.com/en/1.10/topics/db/aggregation/ the aggregation topic], and in a code example in [https://docs.djangoproject.com/en/1.10/ref/contrib/gis/tutorial/ the GeoDjango tutorial].

This is very useful behaviour but it is not widely known.  Additionally, its limitations (see ticket:12611, ""Incorrect quoting in QuerySet.query.__str__()"") are even less widely known.

I think it would be suitable to add this to [https://docs.djangoproject.com/en/1.10/intro/tutorial02/ section 2 of the tutorial], and to the [https://docs.djangoproject.com/en/1.10/topics/db/queries/ Making queries topic guide]."	Cleanup/optimization	assigned	Documentation	1.10	Normal			Ülgen Sarıkavak	Accepted	1	0	0	1	0	0