AccountForm::form() (an similarly RegisterForm::form()) uses the following sentence to describe the email field.

The email address is not made public and will only be used if you wish to receive a new password or wish to receive certain news or notifications by email.

Instead of if you wish to receive a new password it should eventually say if you forget the password. The latter make more explicit which case is being described (considered that if I wish to change my password, I just edit my account to change it, after I provide the current password). To make it more general, I would change the sentence as follow.

The email address is not made public. It will only be used if you need to be contacted about your account or for opted-in notifications.

Issue fork drupal-3110761

Command icon Show commands

Start within a Git clone of the project using the version control instructions.

Or, if you do not have SSH keys set up on git.drupalcode.org:

Support from Acquia helps fund testing for Drupal Acquia logo

Comments

kiamlaluno created an issue. See original summary.

apaderno’s picture

Issue summary: View changes
apaderno’s picture

Issue summary: View changes
apaderno’s picture

Title: Make more explicit the email address is necessary to recovery the password » Make more explicit the email address is necessary to recover the password

(I promise, I will be more careful in posting an issue.)

cilefen’s picture

Issue tags: +Usability
apaderno’s picture

Issue summary: View changes
Vivek Panicker’s picture

Assigned: Unassigned » Vivek Panicker
Vivek Panicker’s picture

Submitting a patch for the issue with the changes as mentioned.

Status: Needs review » Needs work
Sivaji_Ganesh_Jojodae’s picture

Status: Needs work » Needs review

Not sure how the Media_library test fail is relevant here. Patch looks straightforward. Retest requested.

apaderno’s picture

Status: Needs review » Needs work
+      '#description' => $this->t('A valid email address. All emails from the system will be sent to this address. The email address is not made public and will only be used if you need to be contacted about your account, for example, when you forget your password, or you wish to receive certain news or notifications by email.'),

There should not be any comma after for example.

Vivek Panicker’s picture

Assigned: Unassigned » Vivek Panicker

I actually checked it online before submitting the patch.
Still I'll follow the suggestion you mentioned and update the patch.

Vivek Panicker’s picture

Assigned: Vivek Panicker » Unassigned
Status: Needs work » Needs review
FileSize
1.15 KB
Vivek Panicker’s picture

xjm’s picture

Version: 9.0.x-dev » 9.1.x-dev

As a string change, this is a minor-only issue. Since 8.9.x and 9.0.x are now in beta, I'm moving this to 9.1.x. Thanks!

Sivaji_Ganesh_Jojodae’s picture

+++ b/core/modules/user/src/AccountForm.php
@@ -96,7 +96,7 @@ public function form(array $form, FormStateInterface $form_state) {
-      '#description' => $this->t('A valid email address. All emails from the system will be sent to this address. The email address is not made public and will only be used if you wish to receive a new password or wish to receive certain news or notifications by email.'),
+      '#description' => $this->t('A valid email address. All emails from the system will be sent to this address. The email address is not made public and will only be used if you need to be contacted about your account, for example when you forget your password, or you wish to receive certain news or notifications by email.'),

The old phrase "...wish to receive a new password..." makes better sense than new "...when you forget your password..."

Maybe we are undoing something that was purposely introduced?

Sivaji_Ganesh_Jojodae’s picture

Issue tags: +Novice, +Quickfix
himanshu_sindhwani’s picture

Assigned: Unassigned » himanshu_sindhwani
apaderno’s picture

I wish to receive a new password is not the same as I need to receive a new password.
In this case, need makes more sense, as usually users need a new password when they forget the password they used. As for wishing, users would probably wish they never forget their passwords.

will only be used if you wish to receive a new password is also not exact: If users really wish a new password, they just change it from their user account page. Plus, needing a new password is not the only reason for using the email entered from users for their account: The email entered by users is used when they have their contact form enabled, and other users contact them, or when a user with the permission to administer users contact them for any reason linked to their account, which is something user administrator can always do, even if a user didn't enable the contact form.

himanshu_sindhwani’s picture

+ '#description' => $this->t('A valid email address. All emails from the system will be sent to this address. The email address is not made public and will only be used if you need to be contacted about your account, for example when you forget your password, or you wish to receive certain news or notifications by email.'),

I checked the statement seems good semantically and as already mentioned by @kiamlaluno, need is making much more sense that to wish.

+1 For RTBC.

himanshu_sindhwani’s picture

Assigned: himanshu_sindhwani » Unassigned
Ruchi Joshi’s picture

I will apply patch and review this issue

Ruchi Joshi’s picture

FileSize
12.12 KB
11.87 KB

@kiamlaluno New message- "A valid email address. All emails from the system will be sent to this address. The email address is not made public and will only be used if you need to be contacted about your account, for example when you forget your password, or you wish to receive certain news or notifications by email." is more appropriate. Screenshots are attached with and without patch. +1 for RTBC

Version: 9.1.x-dev » 9.2.x-dev

Drupal 9.1.0-alpha1 will be released the week of October 19, 2020, which means new developments and disruptive changes should now be targeted for the 9.2.x-dev branch. For more information see the Drupal 9 minor version schedule and the Allowed changes during the Drupal 9 release cycle.

Version: 9.2.x-dev » 9.3.x-dev

Drupal 9.2.0-alpha1 will be released the week of May 3, 2021, which means new developments and disruptive changes should now be targeted for the 9.3.x-dev branch. For more information see the Drupal core minor version schedule and the Allowed changes during the Drupal core release cycle.

vikashsoni’s picture

applied #14 patch applied successfully
thanks for the patch
For ref sharing screenshot....

kleiton_rodrigues’s picture

Status: Needs review » Reviewed & tested by the community
FileSize
56.74 KB
49.68 KB

patch #14 applied successfully
LGTM moving to RTBC

bnjmnm’s picture

Status: Reviewed & tested by the community » Needs work

Removing credit for redundant screenshots with no additional information.

Setting to "needs work" because this is making an already long description even longer. The element it is in does not have a max width so it will make it even more difficult to read. It would be preferable to communicate the same concepts with a shorter string such as:
This address is not made public. It will only be used for password resets and (if opted-in) notifications.

Making the current description more accurate by extending it's length will dilute its usefulness as the length will reduce the likelihood it is read or correctly interpreted.

anagomes’s picture

Assigned: Unassigned » anagomes

Version: 9.3.x-dev » 9.4.x-dev

Drupal 9.3.0-rc1 was released on November 26, 2021, which means new developments and disruptive changes should now be targeted for the 9.4.x-dev branch. For more information see the Drupal core minor version schedule and the Allowed changes during the Drupal core release cycle.

anagomes’s picture

Assigned: anagomes » Unassigned
Status: Needs work » Needs review
FileSize
1.05 KB

I changed the message according to what @bnjmnm said. I agree that the longer this description gets, the more likely it is to misinterpret it. This new suggestion is shorter and just as clear as the others.

apaderno’s picture

This address is not made public. It will only be used for password resets and (if opted-in) notifications. doesn't say that user administrators can use the email address associated to a user account, even when users disabled the contact tab for their account.

I can agree on trying to make the text shorter, but since the sentence says will only be used for, the text should include all the cases for which the email addresses associated to accounts are used in a plain Drupal installation.

apaderno’s picture

The text I suggested in the IS is unnecessarily long. I would suggest the following one.

The email address is not made public. It will only be used if you need to be contacted about your account (for example when you forget your password) or for opted-in notifications.

(Alternatively, the following one is fine too, IMO.)

The email address is not made public. It will only be used if you need to be contacted about your account or for opted-in notifications.

Clearly, emails associated to accounts can be used for other purposes, but that depends on the modules installed on the site, and Drupal core cannot make a list valid for all the contributed modules. Those modules should alter the description given for the email address field.

andregp’s picture

Status: Needs review » Needs work
anagomes’s picture

Assigned: Unassigned » anagomes
anagomes’s picture

Assigned: anagomes » Unassigned
Status: Needs work » Needs review
FileSize
1.08 KB

Here's a patch based on what @apaderno said in #33.

ilgnerfagundes’s picture

Status: Needs review » Reviewed & tested by the community
FileSize
76.89 KB

patch #36 successfully applied.
The message on the user screen was successfully changed, follow the evidence image, moving to rtbc

Status: Reviewed & tested by the community » Needs work

The last submitted patch, 36: core-make_help_text_more_explicit-3110761-36.patch, failed testing. View results

apaderno’s picture

Status: Needs work » Reviewed & tested by the community

The failures aren't related to this patch.

Status: Reviewed & tested by the community » Needs work

The last submitted patch, 36: core-make_help_text_more_explicit-3110761-36.patch, failed testing. View results

apaderno’s picture

The tests keep failing because this error.

Your XML configuration validates against a deprecated schema.

apaderno’s picture

Status: Needs work » Reviewed & tested by the community
quietone’s picture

Status: Reviewed & tested by the community » Needs work
Issue tags: +Needs issue summary update

Starting a review.

The issue summary is out of date and does not reflect the change being made. Tagging for an Issue Srummary update. This is suitable for a novice. See Write an issue summary for an existing issue for guidance.

This is suggesting a change to user interface text and tagged Usability. So that still needs to happen but having the IS updated will make that easier.

apaderno’s picture

Issue summary: View changes

Version: 9.4.x-dev » 9.5.x-dev

Drupal 9.4.0-alpha1 was released on May 6, 2022, which means new developments and disruptive changes should now be targeted for the 9.5.x-dev branch. For more information see the Drupal core minor version schedule and the Allowed changes during the Drupal core release cycle.

vitorbs’s picture

I will try to work on this issue.

vitorbs’s picture

Assigned: Unassigned » vitorbs
apaderno’s picture

Status: Needs work » Active
Issue tags: -Needs issue summary update
vitorbs’s picture

I did the changes suggested in the summary of the issue and changed the approach for easier review.

vitorbs’s picture

Assigned: vitorbs » Unassigned
Status: Active » Needs review
apaderno’s picture

Status: Needs review » Needs work

The text to use is the following one.

The email address is not made public. It will only be used if you need to be contacted about your account or for opted-in notifications.

(I missed the period.)

The issue fork is using text that isn't suggested in the issue summary.

reenaraghavan’s picture

Assigned: Unassigned » reenaraghavan
reenaraghavan’s picture

Assigned: reenaraghavan » Unassigned
lucassc’s picture

Assigned: Unassigned » lucassc
lucassc’s picture

Hi!

I applied the patch in #36 and did the changes based on what @apaderno said in #51.

Please, review this.

sophiavs’s picture

Assigned: Unassigned » sophiavs

Hi, i will be doing the review

sophiavs’s picture

Assigned: sophiavs » Unassigned
Status: Needs review » Reviewed & tested by the community

Everything looked fine for me, all the new user form with the message passed in #51

alexpott’s picture

Issue tags: -Quickfix

This has not proved to be a quick fix :(

alexpott’s picture

Status: Reviewed & tested by the community » Fixed

I discussed this issue with @Gábor Hojtsy, a drupal product manager. We agreed that the new text is better than the old text and therefore that we should make this change. It is more concise and accurate.

Re issue credit: I've removed credit for screenshots. They are not that useful here - we can read the text in the code. Reviews should consider the usability and correctness of the text. I've tried to credit everyone who had a material affect on the final text.

Committed and pushed 2258208083 to 10.1.x and ec6f344d7c to 10.0.x and 073dd1f255 to 9.5.x. Thanks!

  • alexpott committed 2258208 on 10.1.x
    Issue #3110761 by Vivek Panicker, anagomes, lucassc, apaderno,...

  • alexpott committed ec6f344 on 10.0.x
    Issue #3110761 by Vivek Panicker, anagomes, lucassc, apaderno,...

  • alexpott committed 073dd1f on 9.5.x
    Issue #3110761 by Vivek Panicker, anagomes, lucassc, apaderno,...

Status: Fixed » Closed (fixed)

Automatically closed - issue fixed for 2 weeks with no activity.