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
37458	Add source links for customizable templates and assets in admin documentation	Rickey Shideler	Rickey Shideler	"Several sections of Django's admin documentation reference specific templates and static files that developers may need to customize or inspect. Although some sections link to the overall admin template directory, individual files are not always linked, requiring developers to manually find them.

Ticket - #37127 introduced a version-aware '':sourcefile:'' Sphinx role, which could be used to make these files easier to access directly from the docs.

A few areas that could benefit from this:

- **[https://docs.djangoproject.com/en/dev/intro/tutorial07/#customize-the-admin-look-and-feel Tutorial 7]** — Link `admin/base_site.html` and `admin/index.html`, which developers are instructed to copy and customize.
- **[https://docs.djangoproject.com/en/dev/ref/contrib/admin/#overriding-admin-templates Admin template customization]** — Link specific templates such as `change_form.html` and `change_list.html` where developers are encouraged to inspect or override them.
- **[https://docs.djangoproject.com/en/dev/ref/contrib/admin/filters/ Admin list filters]** — Link `admin/filter.html`, which is referenced as a concrete example for creating custom filter templates.
- **[https://docs.djangoproject.com/en/dev/ref/contrib/admin/#theming-support Admin theming]** — Replace the existing hard-coded GitHub links to `base.css` and `dark_mode.css` with `:sourcefile:` links so they point to the corresponding Django source version.

The goal would be to link individual Django-provided files where the documentation specifically encourages developers to inspect or customize them, rather than linking every file mentioned in the documentation.

Related tickets:
- #37127 — Added version-aware source links for form templates.
- #33842 — Added links to source paths in the documentation.

Forum discussion: https://forum.djangoproject.com/t/when-should-docs-link-to-source-files/45949"	Cleanup/optimization	assigned	Documentation	dev	Normal				Unreviewed	0	0	0	0	1	0