#33910: Clearly explain where 'django.urls.reverse' gets its name
-----------------------------------------+-------------------------------
Reporter: dwysocki | Owner: nobody
Type: Uncategorized | Status: new
Component: Documentation | Version: 4.1
Severity: Normal | Keywords: documentation
Triage Stage: Unreviewed | Has patch: 0
Needs documentation: 0 | Needs tests: 0
Patch needs improvement: 0 | Easy pickings: 0
UI/UX: 0 |
-----------------------------------------+-------------------------------
As a newcomer to Django, I was a very confused where `django.urls.reverse`
got its name. The documentation starts with
{{{
reverse()
If you need to use something similar to the url template tag in your code,
Django provides the following function:
}}}
which doesn't really explain what's being reversed here.
After thinking for a while, it seems the idea is that you're mapping the
view name to its URL, whereas the "default" case is mapping a URL to its
associated view. This really needs to be stated clearly in the docs, as
it's not very intuitive to a new user.
--
Ticket URL: <https://code.djangoproject.com/ticket/33910>
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 [email protected].
To view this discussion on the web visit
https://groups.google.com/d/msgid/django-updates/0107018284574017-ca01f5e3-4a9e-4aec-8ad4-a216dddf8962-000000%40eu-central-1.amazonses.com.
