diff --git a/docs/internals/deprecation.txt b/docs/internals/deprecation.txt
index 3a4c100730..9acd5da611 100644
--- a/docs/internals/deprecation.txt
+++ b/docs/internals/deprecation.txt
@@ -154,6 +154,9 @@ details on these changes.
   :class:`django.middleware.common.BrokenLinkEmailsMiddleware` middleware to
   your :setting:`MIDDLEWARE_CLASSES` setting instead.
 
+* ``django.middleware.doc.XViewMiddleware`` will be removed. Use
+  ``django.contrib.admindocs.middleware.XViewMiddleware`` instead.
+
 * ``Model._meta.module_name`` was renamed to ``model_name``.
 
 * Remove the backward compatible shims introduced to rename ``get_query_set``
diff --git a/docs/ref/settings.txt b/docs/ref/settings.txt
index d7b87c0bd7..f5125f608b 100644
--- a/docs/ref/settings.txt
+++ b/docs/ref/settings.txt
@@ -1490,7 +1490,7 @@ A tuple of IP addresses, as strings, that:
 
 * See debug comments, when :setting:`DEBUG` is ``True``
 * Receive X headers in admindocs if the ``XViewMiddleware`` is installed (see
-  :doc:`/topics/http/middleware`)
+  :doc:`/ref/contrib/admin/admindocs`)
 
 .. setting:: LANGUAGE_CODE