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
28420	Document CallableBool comparison restriction for User.is_authenticated / is_anonymous	Tobi	Tobi	"I have just run into the issue described in https://code.djangoproject.com/ticket/26988, trying to check identity rather then equality on `User.is_authenticated`.

The [https://docs.djangoproject.com/en/1.11/ref/contrib/auth/#django.contrib.auth.models.User.is_authenticated documentation] for this attribute is misleading. It implies that that `is_authenticated` **is** `True` for authenticated users, while in reality the attribute has to be called or checked for equality (`==`) :

  Read-only attribute which is always True (as opposed to AnonymousUser.is_authenticated which is always False). 

I suggest to add a notice/warning to the documentation, that use of *is* / identity checking is not yet supported. There's a similar warning in the deprecation notice for `User.is_authenticated()` [https://docs.djangoproject.com/en/1.11/releases/1.10/#user-is-auth-anon-deprecation here], but neither the warning nor the deprecation notice can be found in the documentation for `contrib.auth.models.User.is_authenticated`

"	Cleanup/optimization	closed	Documentation	1.11	Normal	fixed	documentation		Accepted	1	0	0	0	0	0