diff --git a/docs/topics/auth/passwords.txt b/docs/topics/auth/passwords.txt
index 695c8d2571..b7b2dd4f7a 100644
--- a/docs/topics/auth/passwords.txt
+++ b/docs/topics/auth/passwords.txt
@@ -519,8 +519,9 @@ can write your own as well.
 
 Each password validator must provide a help text to explain the requirements to
 the user, validate a given password and return an error message if it does not
-meet the requirements, and optionally receive passwords that have been set.
-Validators can also have optional settings to fine tune their behavior.
+meet the requirements, and optionally define a callback to be notified when
+the password for a user has been changed. Validators can also have optional
+settings to fine tune their behavior.
 
 Validation is controlled by the :setting:`AUTH_PASSWORD_VALIDATORS` setting.
 The default for the setting is an empty list, which means no validators are