QuerySet reference enhancement + reST cleanup
|Reported by:||gabrielhurley||Owned by:||gabrielhurley|
|Has patch:||yes||Needs documentation:||no|
|Needs tests:||no||Patch needs improvement:||no|
The reST issues aren't really the subject of this ticket (normally I'd just commit those).
However, also in this patch is a chunk that fleshes out the QuerySet class definition. In particular it adds:
- The query and using kwargs to the signature.
- The ordered and db properties (which are marked as "public" in the source, and are mentioned in the docs elsewhere).
While using should certainly be documented as a kwarg, sql.Query isn't a public API so I'm not sure if documenting query is appropriate.
However, the docs say "here's the formal declaration of a QuerySet" so I'm inclined to say that the declaration should be complete.
I just wanted to get a quick nod from someone else on this one.