Inconsistent documentation: refers to a "root QuerySet", which is really a Manager instance.
|Reported by:||Owned by:||nobody|
|Cc:||James Pic||Triage Stage:||Accepted|
|Has patch:||yes||Needs documentation:||no|
|Needs tests:||no||Patch needs improvement:||no|
"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."
"(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.
Change History (5)
comment:1 Changed 4 years ago by
|Patch needs improvement:||unset|
|Triage Stage:||Unreviewed → Accepted|
|Type:||Uncategorized → Cleanup/optimization|