diff --git a/docs/ref/contrib/comments/upgrade.txt b/docs/ref/contrib/comments/upgrade.txt
index b3656f31dd8ed..e1ff4ed2cd82b 100644
--- a/docs/ref/contrib/comments/upgrade.txt
+++ b/docs/ref/contrib/comments/upgrade.txt
@@ -26,6 +26,15 @@ The main changes from the old system are:
       new comment, and ``{% render_comment_form %}``, which renders said form
       using the ``comments/form.html`` template.
 
+    * The way comments are include in your URLconf have changed; you'll need to
+      replace::
+
+            (r'^comments/', include('django.contrib.comments.urls.comments')),
+
+      with::
+
+            (r'^comments/', include('django.contrib.comments.urls')),
+
 Upgrading data
 --------------