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	The register decorator description is badly worded - needs clarification	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	new	Documentation	1.11	Normal		register decorator		Unreviewed	0	0	0	0	1	0