﻿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
19717	"Inconsistent documentation: refers to a ""root QuerySet"", which is really a Manager instance."	julien.aubert.mail@…	nobody	"https://docs.djangoproject.com/en/dev/topics/db/queries/#retrieving-objects

""The Manager is the main source of QuerySets for a model. It acts as a ""root"" QuerySet that describes all objects in the model's database table. For example, Blog.objects is the initial QuerySet that contains all Blog objects in the database.""

further down

""(If Entry.objects is a QuerySet, why can't we just do Entry.objects? That's because Entry.objects, the root QuerySet, is a special case that cannot be evaluated. The all() method returns a QuerySet that can be evaluated.)""

Entry.objects is a Manager instance and not a QuerySet. To refer to a ""root QuerySet"" which really is a Manager instance does not help, just adds confusion. I would suggest to remove any reference to ""root QuerySet"" in all the doc.
"	Cleanup/optimization	closed	Documentation	1.5-beta-1	Normal	fixed		James Pic	Accepted	1	0	0	0	1	0
