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
22019	add section for definitive Model.objects documentation	Chris Jerdonek	anonymous	"I can't seem to find the model class attribute `objects` documented in any of the [https://docs.djangoproject.com/en/dev/ref/models/ models reference sections].  In addition, there doesn't seem to be an obvious central place where `objects` is documented (and in particular, a clear place where the word ""objects"" can internally link to).  I think this place should be somewhere in the reference/API section.

Currently, the most detailed documentation of `objects` seems to be [https://docs.djangoproject.com/en/dev/topics/db/queries/#retrieving-objects here], in the ""Retrieving objects"" subsection of the ""Making queries"" section of the introductory ""Models and databases"" topic section.  However, `objects` is referred to much earlier than that, for example several times in the [https://docs.djangoproject.com/en/dev/topics/db/models/ previous ""Models"" section].

My recommendations would be:

* add to the Models reference a definitive section about the `objects` class attribute, and include there a hyperlink to the introductory section about `objects` that I mentioned above,
* hyperlink the first mentions of `objects` in the models introductory sections to the definitive section, and
* in particular, hyperlink the introductory section about `objects` to the definitive section.
"	Cleanup/optimization	closed	Documentation	1.6	Normal	fixed	models nlsprint14	chris.jerdonek@… eromijn@…	Accepted	0	0	0	0	1	0