#23573: Should tutorial 2 demonstrate AdminSite.site_header instead of
overriding
templates?
--------------------------------------+------------------------------------
Reporter: hernandocounty | Owner: nobody
Type: Cleanup/optimization | Status: new
Component: Documentation | Version: 1.7
Severity: Normal | Resolution:
Keywords: | Triage Stage: Accepted
Has patch: 0 | Needs documentation: 0
Needs tests: 0 | Patch needs improvement: 0
Easy pickings: 0 | UI/UX: 0
--------------------------------------+------------------------------------
Changes (by aaugustin):
* status: closed => new
* component: Template system => Documentation
* keywords: TEMPLATES_DIR =>
* needs_docs: 1 => 0
* resolution: invalid =>
* stage: Unreviewed => Accepted
Old description:
> ok just because I got my ass reemed by a bunch of overly sensitive people
> in my opinion,
>
> here is a better version of my point.
>
> we have a DRY principle with Django.
>
> it saves us time
>
> so the 1.7 thingy cost me some time. not that big of a deal. but
> evidently complaining to volunteers is.
>
> So whatever.. take it how you will. I would certainly be happy to
> contribute to documentation but mostly my experience with these
> opensource projects is most of the people that run them think they are
> GODS of computer world and are usually rude in the first place and would
> not give me the time of day to contribute anyways.
>
> I love Django. I love Open Source. I love all the people that contribute
> to this stuff. Honestly Do.
>
> So here is the way I found to do this a little easier.
>
> http://stackoverflow.com/questions/4938491/django-admin-change-header-
> django-administration-text
New description:
Tutorial 2 shows how to change the admin's header (see also #21378).
However, in Django 1.7, there's a better way to achieve this particular
task:
[https://docs.djangoproject.com/en/1.7/ref/contrib/admin/#django.contrib.admin.AdminSite.site_header
AdminSite.site_header].
If that example is intended to demonstrate how to override a template,
then it should tackle another use case for which overriding templates is
the simplest choice.
If it is intended to show how to customize the admin's header, then it
should describe the simplest solution.
--
Comment:
I've rewritten the ticket because the state of the reporter's ass is only
marginally relevant to the Django project ;-) However, the idea is valid.
--
Ticket URL: <https://code.djangoproject.com/ticket/23573#comment:4>
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/072.8648c8ca902e34b23e16b0d90ceb9bd9%40djangoproject.com.
For more options, visit https://groups.google.com/d/optout.