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
20460	Documentation for customer user models should warn about naming it User	Marc Tamlyn	nobody	If you swap in a customer user model where the name of the class is not `User`, and you are using `PermissionsMixin`, then (for example) the `Group` model will no longer have a `user_set` related object descriptor. This should be documented as a warning when using custom user models with the `PermissionsMixin`, and suggest that the fix (may be) to use a modified `PermissionsMixin` which specifies the `related_name` exactly.	Cleanup/optimization	closed	Documentation	1.5	Normal	duplicate	contrib.auth, swappable user	Marc Tamlyn	Accepted	0	0	0	0	1	0