From 2c931fda5b341e0febf68269d2c2447a64875127 Mon Sep 17 00:00:00 2001
From: lucas-r-oliveira <lucasoliveira7c@gmail.com>
Date: Sat, 8 Jun 2024 12:49:08 +0200
Subject: [PATCH] Fixed 35506 -- Clarified initial references to URLconf in
 tutorial 1.

---
 docs/intro/tutorial01.txt | 39 +++++++++++++++++++++------------------
 1 file changed, 21 insertions(+), 18 deletions(-)

diff --git a/docs/intro/tutorial01.txt b/docs/intro/tutorial01.txt
index f506fc605d..d00dd626ce 100644
--- a/docs/intro/tutorial01.txt
+++ b/docs/intro/tutorial01.txt
@@ -222,10 +222,25 @@ and put the following Python code in it:
     def index(request):
         return HttpResponse("Hello, world. You're at the polls index.")
 
-This is the simplest view possible in Django. To call the view, we need to map
-it to a URL - and for this we need a URLconf.
+This is the most basic view possible in Django. To access it in a browser, we
+need to map it to a URL - and for this we need to define a URL configuration,
+or "URLconf" for short. These URL configurations are defined inside each
+Django app, and they are Python files named ``urls.py``.
+
+To define a URLconf for the ``polls`` app, create a file ``polls/urls.py``
+with the following content:
+
+.. code-block:: python
+    :caption: ``polls/urls.py``
+
+    from django.urls import path
+
+    from . import views
+
+    urlpatterns = [
+        path("", views.index, name="index"),
+    ]
 
-To create a URLconf in the polls directory, create a file called ``urls.py``.
 Your app directory should now look like:
 
 .. code-block:: text
@@ -241,21 +256,9 @@ Your app directory should now look like:
         urls.py
         views.py
 
-In the ``polls/urls.py`` file include the following code:
-
-.. code-block:: python
-    :caption: ``polls/urls.py``
-
-    from django.urls import path
-
-    from . import views
-
-    urlpatterns = [
-        path("", views.index, name="index"),
-    ]
-
-The next step is to point the root URLconf at the ``polls.urls`` module. In
-``mysite/urls.py``, add an import for ``django.urls.include`` and insert an
+The next step is to configure the global URLconf in the ``mysite`` project to
+include the URLconf defined in ``polls.urls``. To do this, add an import for
+``django.urls.include`` in ``mysite/urls.py`` and insert an
 :func:`~django.urls.include` in the ``urlpatterns`` list, so you have:
 
 .. code-block:: python