#25153: The polls tutorial shows INSTALLED_APPS in incorrect order
-------------------------------+--------------------------------------
Reporter: pjdelport | Owner: nobody
Type: Bug | Status: closed
Component: Documentation | Version: 1.8
Severity: Normal | Resolution: worksforme
Keywords: | Triage Stage: Unreviewed
Has patch: 0 | Needs documentation: 0
Needs tests: 0 | Patch needs improvement: 0
Easy pickings: 1 | UI/UX: 0
-------------------------------+--------------------------------------
Comment (by pjdelport):
Overriding templates from a separate project-level template directory does
work, but that's a different solution, and not a replacement for
application-level template overrides. (The same for static files and other
app resources.)
The tutorial discusses both kinds of overriding later on, including the
specific example of overriding admin templates at the application (not
project) level
([https://github.com/django/django/blob/3653466bdf211ca603ec976c28d4a8da566dc671/docs/intro/tutorial07.txt#L385-L390
link]), which simply won't work with the example's `INSTALLED_APPS`
ordering until it is fixed.
To summarize, I think that the example's ordering is harmful, or at least
counter-productive, for the following reasons,:
1. It's inconsistent with the Django's reference documentation about what
the ordering should be.
2. It's inconsistent with the remainder of the tutorial.
3. It gives beginners the wrong working intuition about `INSTALLED_APPS`'s
precedence at a key learning window, which they'll invariably have to get
bitten by and unlearn when they actually start using or creating Django
apps and libraries more seriously.
Fixing the example should not have any drawbacks, while resolving these
problems.
Would you reconsider the decision to close this issue? (I would be happy
to submit a PR.)
--
Ticket URL: <https://code.djangoproject.com/ticket/25153#comment:2>
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/067.adc500ed504a4693950011a0fec76fab%40djangoproject.com.
For more options, visit https://groups.google.com/d/optout.
