From 6687f4dcbbfeca81b76233609fca90f30ce4dd25 Mon Sep 17 00:00:00 2001
From: Marten Kenbeek <marten.knbk@gmail.com>
Date: Wed, 30 Dec 2015 17:13:58 +0100
Subject: [PATCH] Refs #21927 -- Added note about include() to tutorial.

---
 docs/intro/tutorial01.txt | 5 +++++
 1 file changed, 5 insertions(+)

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