diff --git a/docs/ref/urlresolvers.txt b/docs/ref/urlresolvers.txt
index aa0fe0d60d..8e9634c31d 100644
--- a/docs/ref/urlresolvers.txt
+++ b/docs/ref/urlresolvers.txt
@@ -26,6 +26,7 @@ you can use any of the following to reverse the URL::
     reverse('news_archive')
 
     # passing a callable object
+    # (This is discouraged because you can't reverse namespaced views this way.)
     from news import views
     reverse(views.archive)