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
28777	Clarify the docs for admin's @register's arguments	Matt Swan	nobody	"The description text for the register decorator has a complex sentence that is badly worded and not proper english, meaning that the functions usage is not properly described.  

This page:
[https://docs.djangoproject.com/en/1.11/ref/contrib/admin/]
Please reword this sentence so it make sense:

  It is given one or more model classes to register with the ModelAdmin and an optional keyword argument site if you are not using the default AdminSite:

Suggested changes - but I don't understand the sentence so the suggestion is just a guess:

""It is given IF/FOR(?) one or more model classes to register with the ModelAdmin and an optional keyword argument site FULL STOP. If you are not using the default AdminSite:""
"	Cleanup/optimization	closed	Documentation	1.11	Normal	fixed	register decorator		Ready for checkin	1	0	0	0	1	0