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
15558	QuerySet reference enhancement + reST cleanup	Gabriel Hurley	Gabriel Hurley	"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:

  1. The `query` and `using` kwargs to the signature.
  2. 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."		closed	Documentation	1.2		fixed			Accepted	1	0	0	0	0	0