[2.2.x] Fixed #30600 -- Clarified that ValueError raised by converter.to_python() means no match.

Backport of f197c3dd9130b18397022605c27ffe5755f329d7 from master

1 files changed, 3 insertions, 1 deletions

diff --git a/docs/topics/http/urls.txt b/docs/topics/http/urls.txt
index 3a17a45322..ed7257d847 100644
--- a/docs/topics/http/urls.txt
+++ b/docs/topics/http/urls.txt
@@ -146,7 +146,9 @@ A converter is a class that includes the following:
 
 * A ``to_python(self, value)`` method, which handles converting the matched
   string into the type that should be passed to the view function. It should
-  raise ``ValueError`` if it can't convert the given value.
+  raise ``ValueError`` if it can't convert the given value. A ``ValueError`` is
+  interpreted as no match and as a consequence a 404 response is sent to the
+  user.
 
 * A ``to_url(self, value)`` method, which handles converting the Python type
   into a string to be used in the URL.