Fixed #21414 -- Removed RelatedObject and deprecated Field.related.

2 files changed, 12 insertions, 0 deletions

diff --git a/docs/internals/deprecation.txt b/docs/internals/deprecation.txt
index 54d86cbf23..fa3683c7fe 100644
--- a/docs/internals/deprecation.txt
+++ b/docs/internals/deprecation.txt
@@ -99,6 +99,8 @@ details on these changes.
   ``'django.contrib.auth.middleware.SessionAuthenticationMiddleware'`` is in
   ``MIDDLEWARE_CLASSES``.
 
+* Private attribute ``django.db.models.Field.related`` will be removed.
+
 .. _deprecation-removed-in-1.9:
 
 1.9
diff --git a/docs/releases/1.8.txt b/docs/releases/1.8.txt
index 3dc075a7c8..e2cb8cd2ff 100644
--- a/docs/releases/1.8.txt
+++ b/docs/releases/1.8.txt
@@ -1226,6 +1226,16 @@ to your ``MIDDLEWARE_CLASSES`` sometime before then to opt-in. Please read the
 ``django.contrib.flatpages.sitemaps.FlatPageSitemap``. The old import location
 is deprecated and will be removed in Django 1.9.
 
+Model ``Field.related``
+~~~~~~~~~~~~~~~~~~~~~~~
+
+Private attribute ``django.db.models.Field.related`` is deprecated in favor
+of ``Field.rel``.  The latter is an instance of
+``django.db.models.fields.related.ForeignObjectRel`` which replaces
+``django.db.models.related.RelatedObject``. The ``django.db.models.related``
+module has been removed and the ``Field.related`` attribute will be removed in
+Django 2.0.
+
 .. removed-features-1.8:
 
 Features removed in 1.8