id	summary	reporter	owner	description	type	status	component	version	severity	resolution	keywords	cc	stage	has_patch	needs_docs	needs_tests	needs_better_patch	easy	ui_ux
29999	Include overriding admin site to tutorial	Jan Musílek	nobody	"Django 2.1 introduced ability to [https://docs.djangoproject.com/en/2.1/ref/contrib/admin/#overriding-default-admin-site override default admin site], which is a great feature. In the [https://docs.djangoproject.com/en/2.1/intro/tutorial07/#customize-the-admin-look-and-feel tutorial], change of the heading is achieved by overriding templates. I'm aware that it's done so because of teaching new users how to override templates (as stated in the tutorial itself), but I think that ability to override default admin should be mentioned in this place as well.

In the spirit of ''""There should be one – and preferably only one – obvious way to do it.""'' I think that overriding the default admin site is the obvious way to customize django admin site from now on and therefore, it should be mentioned in the tutorial.

**Currently, the documentation states (this paragraph has not been changed at least from Django 1.9):**

* We use this approach to teach you how to override templates. In an actual project, you would probably use the [https://docs.djangoproject.com/en/2.1/ref/contrib/admin/#django.contrib.admin.AdminSite.site_header django.contrib.admin.AdminSite.site_header] attribute to more easily make this particular customization.

**I propose to change this paragraph thus:**

* We use this approach to teach you how to override templates. In an actual project, you would probably [https://docs.djangoproject.com/en/2.1/ref/contrib/admin/#overriding-default-admin-site override the default admin site] and use [https://docs.djangoproject.com/en/2.1/ref/contrib/admin/#django.contrib.admin.AdminSite.site_header django.contrib.admin.AdminSite.site_header] attribute to more easily make this particular customization."	Cleanup/optimization	closed	Documentation	2.1	Normal	wontfix			Unreviewed	0	0	0	0	1	0