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
21661	Password reset part of django.auth isn't documented	cortex@…	chris cauley	"Hello,

Last time I've got the chance to talk to a django core dev, he told me that an API reference isn't a suffisent documentation according to django standard. Therefor, I open a bug on the ""password reset"" part of contrib.auth because the only thing that you can find is a list of function documentation starting here https://docs.djangoproject.com/en/1.6/topics/auth/default/#django.contrib.auth.views.password_reset

Thing that could be add in this documentation might be:

* a description on how you are supposed to use this/implement this in your application
* an example urls.py with the correct ""name"" keyword arguments of the function url
* an example of customisation (all of those functions accept a lot of customisation arguments, how to I use it?)
* which default templates are used and how to overwrite them

IMO, a not very advanced django user would have greats difficulties to use those features witht the current state of the documentation and would probably not succeed. Also, those features aren't visible at all, you really need to know that they exist or have the chance to stumble upon them.

Kind regards,"	Cleanup/optimization	closed	Documentation	1.6	Normal	fixed			Accepted	1	0	0	0	1	0