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
21726	Documentation for REQUIRED_FIELDS on custom users is ambiguous	Russell Keith-Magee	Tim Graham <timograham@…>	"The [https://docs.djangoproject.com/en/1.6/topics/auth/customizing/#django.contrib.auth.models.CustomUser.REQUIRED_FIELDS documentation for the REQUIRED_FIELDS definition on a custom user model] describes what fields must be included in required fields. It includes a note that says that USERNAME_FIELD should not be included in REQUIRED_FIELDS. 

However, it doesn't say anything about password - which is a required field, and would otherwise meet the requirements of the REQUIRED_FIELDS definition. The note should be expanded (and the general definition clarified) to specifically exclude password.

This doesn't actually cause any problems -- it just means that the createsuperuser command asks for the password three times, instead of two, but it is confusing behaviour. "	Bug	closed	Documentation	1.5	Normal	fixed			Accepted	1	0	0	0	1	0