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