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
23725	Inconsistent documentation about ForeignKey(User)	Raúl Cumplido	Raúl Cumplido	"In the documentation when we are saying to reference to the User model we say (https://github.com/django/django/blob/master/docs/topics/auth/customizing.txt#L429):
{{{
#!div style=""font-size: 80%""
Code highlighting:
  {{{#!python
When you define a foreign key or many-to-many relations to the User model,
you should specify the custom model using the :setting:`AUTH_USER_MODEL`
setting.
  }}}
}}}

We also recommend to use it in troubleshooting here (https://github.com/django/django/blob/master/docs/ref/applications.txt#L402)

But in other parts of the documentation we are still referring and having examples to do it from the User model on django.contrib.auth.models directly (https://github.com/django/django/blob/master/docs/ref/models/fields.txt#L1264, https://github.com/django/django/blob/master/docs/topics/auth/customizing.txt#L311):
{{{
#!div style=""font-size: 80%""
Code highlighting:
  {{{#!python
from django.contrib.auth.models import User
  }}}
}}}

Shouldn't it be good to have consistency and to remove the later examples to match the ones we recommend?"	Cleanup/optimization	closed	Documentation	1.7	Normal	fixed		raulcumplido@…	Accepted	1	0	0	0	1	0