Merge pull request #2363 from nheyning/22019_add_objects_doc

Fixed #22019 -- added documentation on Model attributes

2 files changed, 15 insertions, 0 deletions

diff --git a/docs/topics/db/models.txt b/docs/topics/db/models.txt
index 5039bbd2d1..a8445a2cf5 100644
--- a/docs/topics/db/models.txt
+++ b/docs/topics/db/models.txt
@@ -663,6 +663,19 @@ Meta`` to a model is completely optional.
 A complete list of all possible ``Meta`` options can be found in the :doc:`model
 option reference </ref/models/options>`.
 
+.. _model-attributes:
+
+Model attributes
+================
+
+:attr:`~objects`
+    The most important attribute of a model is the 
+    :class:`~django.db.models.Manager`, which is the interface through which 
+    database query operations are provided to Django models and is used to 
+    :ref:`retrieve the instances <retrieving-objects>` from the database. If no 
+    custom Manager is defined, the default name is ``objects``. Managers are 
+    only accessible via model classes, not the model instances. 
+
 .. _model-methods:
 
 Model methods
diff --git a/docs/topics/db/queries.txt b/docs/topics/db/queries.txt
index f53d1a9998..66118631e0 100644
--- a/docs/topics/db/queries.txt
+++ b/docs/topics/db/queries.txt
@@ -129,6 +129,8 @@ go, include multiple arguments in the call to
 
 Django will complain if you try to assign or add an object of the wrong type.
 
+.. _retrieving-objects:
+
 Retrieving objects
 ==================