Fixed #23558 -- documented slugify limitations

2 files changed, 6 insertions, 6 deletions

diff --git a/django/template/defaultfilters.py b/django/template/defaultfilters.py
index 3e35e67bd0..16a3d4d6e9 100644
--- a/django/template/defaultfilters.py
+++ b/django/template/defaultfilters.py
@@ -228,9 +228,9 @@ def make_list(value):
 @stringfilter
 def slugify(value):
     """
-    Converts to lowercase, removes non-word characters (alphanumerics and
-    underscores) and converts spaces to hyphens. Also strips leading and
-    trailing whitespace.
+    Converts to ASCII. Converts spaces to hyphens. Removes characters that
+    aren't alphanumerics, underscores, or hyphens. Converts to lowercase.
+    Also strips leading and trailing whitespace.
     """
     return _slugify(value)
 
diff --git a/django/utils/text.py b/django/utils/text.py
index b2645e8697..37bcd3150e 100644
--- a/django/utils/text.py
+++ b/django/utils/text.py
@@ -438,9 +438,9 @@ unescape_string_literal = allow_lazy(unescape_string_literal)
 
 def slugify(value):
     """
-    Converts to lowercase, removes non-word characters (alphanumerics and
-    underscores) and converts spaces to hyphens. Also strips leading and
-    trailing whitespace.
+    Converts to ASCII. Converts spaces to hyphens. Removes characters that
+    aren't alphanumerics, underscores, or hyphens. Converts to lowercase.
+    Also strips leading and trailing whitespace.
     """
     value = force_text(value)
     value = unicodedata.normalize('NFKD', value).encode('ascii', 'ignore').decode('ascii')