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
34494	This is suggestion about customizing AdminSite documents	jianghan	nobody	"When I was using customizing adminsite and admindoc, I encountered an error message:

{{{
Reverse for 'app_list' with keyword arguments '{'app_label': 'auth'}' not found.
}}}

I wrote a custom adminsite according to the document code:

{{{
# admin.py
class MyAdminSite(admin.AdminSite):
    site_header = ""Django4 Demo""

admin_site = MyAdminSite(name=""myadmin"")

# urls.py
urlpatterns = [
    path('admin/doc/', include('django.contrib.admindocs.urls')),
    path(""admin/"", admin_site.urls),
]

# settings.py
INSTALLED_APPS = [
    ""django.contrib.admindocs"",
    # ""django.contrib.admin"",
    ""django4demo.apps.MyAdminConfig"",
    ...
]
}}}
At the same time, I also installed admindoc.
After starting, click on ""Document"" on the page and the above error will appear.

Upon investigation, it was found that admindoc was using ""admin. site"" object from ""django. contrib import admin"".
And the route registration uses a custom ""admin_site"" object.
When ""resolve(auth)""，the route cannot be found, Because there is no under the custom ""admin_site.urls"".

When I replaced all ""admin_site"" object with native ""admin.site"" object, the problem was resolved.

Suggest adding relevant comments on the adminsite document to prevent others from falling into the trap.

thanks.
"	Uncategorized	closed	Documentation	4.2	Normal	invalid			Unreviewed	0	0	0	0	0	0