[1.9.x] Refs #21927 -- Added note about include() to tutorial.

Backport of 6687f4dcbbfeca81b76233609fca90f30ce4dd25 from master

1 files changed, 5 insertions, 0 deletions

diff --git a/docs/intro/tutorial01.txt b/docs/intro/tutorial01.txt
index 7255f2b3ee..0bdc593ec9 100644
--- a/docs/intro/tutorial01.txt
+++ b/docs/intro/tutorial01.txt
@@ -298,6 +298,11 @@ an :func:`~django.conf.urls.include` in the ``urlpatterns`` list, so you have:
         url(r'^admin/', admin.site.urls),
     ]
 
+.. admonition:: When to use :func:`~django.conf.urls.include()`
+
+    You should always use ``include()`` when you include other URL patterns.
+    ``admin.site.urls`` is the only exception to this.
+
 .. admonition:: Doesn't match what you see?
 
     If you're seeing ``include(admin.site.urls)`` instead of just