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
27053	Document django.contrib.auth.get_user()	Kevin Christopher Henry	Berker Peksag	"Essentially all the work of `AuthenticationMiddleware` is done by [https://github.com/django/django/blob/b387189d86aa6f0b8dd5e9ff2facb725e6beb7a9/django/contrib/auth/__init__.py#L172 django.contrib.auth.get_user()]. For anyone who wants to customize this behavior (for example, fetching users on some requests but not others), then, this function is very helpful. It deals properly with error conditions and edge cases, and is what implements [https://docs.djangoproject.com/en/dev/topics/auth/default/#session-invalidation-on-password-change session invalidation on password change].

For that reason, I think this function should be documented and become a first-class part of the API."	Cleanup/optimization	closed	Documentation	dev	Normal	fixed		berker.peksag@…	Accepted	1	0	0	0	0	0