#25153: The polls tutorial shows INSTALLED_APPS in incorrect order
-------------------------------+--------------------
Reporter: pjdelport | Owner: nobody
Type: Bug | Status: new
Component: Documentation | Version: 1.8
Severity: Normal | Keywords:
Triage Stage: Unreviewed | Has patch: 0
Easy pickings: 1 | UI/UX: 0
-------------------------------+--------------------
The polls tutorial currently gives an example value for `INSTALLED_APPS`
that's not in the correct order
([https://github.com/django/django/blob/3653466bdf211ca603ec976c28d4a8da566dc671/docs/intro/tutorial02.txt#L208-L216
source]):
{{{
INSTALLED_APPS = [
'django.contrib.admin',
'django.contrib.auth',
'django.contrib.contenttypes',
'django.contrib.sessions',
'django.contrib.messages',
'django.contrib.staticfiles',
'polls',
]
}}}
As the Django docs explain elsewhere
([https://docs.djangoproject.com/en/1.8/ref/settings/#installed-apps
settings reference],
[https://docs.djangoproject.com/en/1.8/ref/templates/api/#django.template.loaders.app_directories.Loader
templates API]), `INSTALLED_APPS` should be listed in precedence order,
with higher-level apps preceding the apps that they depend on and
override.
Later parts of the tutorial actually depend on this, when it discusses
customizing the admin templates from the polls app. (Every time I've
helped someone through the polls tutorial, and they attempt to customize
the admin template, I've had to explain and help them fix this.)
--
Ticket URL: <https://code.djangoproject.com/ticket/25153>
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 post to this group, send email to [email protected].
To view this discussion on the web visit
https://groups.google.com/d/msgid/django-updates/052.21892621750e21cd6827a55c28b64658%40djangoproject.com.
For more options, visit https://groups.google.com/d/optout.
