diff --git a/core/modules/user/src/Form/UserPasswordForm.php b/core/modules/user/src/Form/UserPasswordForm.php
index 347dbc42d4ec72372c1a65fa7d7815ea3d169be8..7bb2f830ae8ca12c32f3b7bbe65240abe65f3730 100644
--- a/core/modules/user/src/Form/UserPasswordForm.php
+++ b/core/modules/user/src/Form/UserPasswordForm.php
@@ -13,6 +13,8 @@
 /**
  * Provides a user password reset form.
  *
+ * Send the user an email to reset their password.
+ *
  * @internal
  */
 class UserPasswordForm extends FormBase {
diff --git a/core/modules/user/src/Form/UserPasswordResetForm.php b/core/modules/user/src/Form/UserPasswordResetForm.php
index 1f5ab59b8361f69c172bf8488a5a4d2ec0552849..a53c716e20d4004abb3b9d7ffa8db1cf20999d1b 100644
--- a/core/modules/user/src/Form/UserPasswordResetForm.php
+++ b/core/modules/user/src/Form/UserPasswordResetForm.php
@@ -10,6 +10,8 @@
 /**
  * Form controller for the user password forms.
  *
+ * Users followed the link in the email, now they can enter a new password.
+ *
  * @internal
  */
 class UserPasswordResetForm extends FormBase {