Ticket #10952: 10952.diff

docs/topics/auth.txt

@@ -869 +869 @@
 
 .. function:: views.password_reset(request[, is_admin_site, template_name, email_template_name, password_reset_form, token_generator, post_reset_redirect])
 
-    Allows a user to reset their password, and sends them the new password
-    in an e-mail.
+    Allows a user to reset their password by generating a one-time use link
+    for doing so and emailing it to the user.
 
     **Optional arguments:**
 
@@ -976 +976 @@
 
 .. class:: PasswordResetForm
 
-    A form for resetting a user's password and e-mailing the new password to
-    them.
+    A form for generating and e-mailing a one-time use link to reset a user's
+    password.
 
 .. class:: SetPasswordForm