4 files changed, 15 insertions, 0 deletions

diff --git a/docs/internals/deprecation.txt b/docs/internals/deprecation.txt
index e91ac062cb..8072075864 100644
--- a/docs/internals/deprecation.txt
+++ b/docs/internals/deprecation.txt
@@ -74,6 +74,9 @@ details on these changes.
 * The setter for ``django.contrib.gis.gdal.OGRGeometry.coord_dim`` will be
   removed.
 
+* ``django.urls.register_converter()`` will no longer allow overriding existing
+  converters.
+
 .. _deprecation-removed-in-5.1:
 
 5.1
diff --git a/docs/ref/urls.txt b/docs/ref/urls.txt
index e8d51eeda2..2ef873d348 100644
--- a/docs/ref/urls.txt
+++ b/docs/ref/urls.txt
@@ -120,6 +120,10 @@ The ``converter`` argument is a converter class, and ``type_name`` is the
 converter name to use in path patterns. See
 :ref:`registering-custom-path-converters` for an example.
 
+.. deprecated:: 5.1
+
+    Overriding existing converters is deprecated.
+
 ==================================================
 ``django.conf.urls`` functions for use in URLconfs
 ==================================================
diff --git a/docs/releases/5.1.txt b/docs/releases/5.1.txt
index a4a7f359c6..9a2f2fc6cc 100644
--- a/docs/releases/5.1.txt
+++ b/docs/releases/5.1.txt
@@ -419,6 +419,9 @@ Miscellaneous
 * Setting ``django.contrib.gis.gdal.OGRGeometry.coord_dim`` is deprecated. Use
   :meth:`~django.contrib.gis.gdal.OGRGeometry.set_3d` instead.
 
+* Overriding existing converters with ``django.urls.register_converter()`` is
+  deprecated.
+
 Features removed in 5.1
 =======================
 
diff --git a/docs/topics/http/urls.txt b/docs/topics/http/urls.txt
index d8de9635ec..8e57732725 100644
--- a/docs/topics/http/urls.txt
+++ b/docs/topics/http/urls.txt
@@ -183,6 +183,11 @@ Register custom converter classes in your URLconf using
         ...,
     ]
 
+.. deprecated:: 5.1
+
+    Overriding existing converters with ``django.urls.register_converter()`` is
+    deprecated.
+
 Using regular expressions
 =========================