#35506: Rewrite confusing "URLconf" references in the Tutorial Part 1
-------------------------------------+-------------------------------------
Reporter: | Owner: lucas-r-oliveira
lucas-r-oliveira |
Type: | Status: assigned
Cleanup/optimization |
Component: | Version: dev
Documentation | Keywords: documentation,
Severity: Normal | tutorial, rewrite
Triage Stage: | Has patch: 0
Unreviewed |
Needs documentation: 0 | Needs tests: 0
Patch needs improvement: 0 | Easy pickings: 1
UI/UX: 0 |
-------------------------------------+-------------------------------------
The term "URLconf" can be confusing and distracting for the user.
It is first mentioned with no context whatsoever, and it keeps getting
used throughout the tutorial.
As the tutorial progresses, it just keeps getting more and more confusing.
At first it may seem like it is a class. At a second glance, it may seem
like it's the name given to the urls.py file. At some point, it may even
look like it's each "path" inside the urlpatterns variable.
It is important to not confuse the user with too many technical terms at
this stage. Especially, since the user hasn't yet been able to see any
result once it gets here.
[https://docs.djangoproject.com/en/dev/intro/tutorial01/#write-your-first-
view]
--
Ticket URL: <https://code.djangoproject.com/ticket/35506>
Django <https://code.djangoproject.com/>
The Web framework for perfectionists with deadlines.
--
You received this message because you are subscribed to the Google Groups
"Django updates" group.
To unsubscribe from this group and stop receiving emails from it, send an email
to django-updates+unsubscr...@googlegroups.com.
To view this discussion on the web visit
https://groups.google.com/d/msgid/django-updates/0107018ff76c36a3-6864a76e-9147-4e7a-89ee-d49d32a159d6-000000%40eu-central-1.amazonses.com.
