django/django — pull request #185 by evildmp (2012-07-05 21:11:37+00:00)
Title: docs and comments in settings.py to explain template overriding

I spent a lot of time trying to work out why my own base_site.html template wasn't overriding Django's.

Eventually I realised that it was because django.contrib.admin was listed in INSTALLED_APPLICATIONS before my own application, and so its base_site.html won the race to be chosen.

I'm a slow learner, so I went through the same thing all over again today, a year or more later...

To help people like me, I have added a comment in the settings.py of the project template, and a note in the docs.

I considered adding it in part 2 of the tutorial, https://docs.djangoproject.com/en/1.4/intro/tutorial02/, but I felt it was probably a bit much to put in front of a new user.

If I have not submitted this in the correct format let me know and I will have another try.