diff --git a/docs/topics/http/urls.txt b/docs/topics/http/urls.txt
index 4bb3b78d97c..9b6e2d07492 100644
--- a/docs/topics/http/urls.txt
+++ b/docs/topics/http/urls.txt
@@ -808,6 +808,8 @@ This ``current_app`` argument is used as a hint to resolve application
 namespaces into URLs on specific application instances, according to the
 :ref:`namespaced URL resolution strategy <topics-http-reversing-url-namespaces>`.
 
+``args`` and ``kwargs`` cannot be passed to ``reverse()`` at the same time.
+
 .. admonition:: Make sure your views are all correct.
 
     As part of working out which URL names map to which patterns, the