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.
Comment | File | Size | Author |
---|---|---|---|
#55 | interdiff_36-55.txt | 900 bytes | lucassc |
#55 | core-make_help_text_more_explicit-3110761-55.patch | 1 KB | lucassc |
#27 | after_3110761_27.jpg | 49.68 KB | kleiton_rodrigues |
#27 | before_3110761_27.jpg | 56.74 KB | kleiton_rodrigues |
#26 | 3110761--after--patch--pic.png | 16.73 KB | vikashsoni |
Issue fork drupal-3110761
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:
Comments
Comment #2
apadernoComment #3
apadernoComment #4
apaderno(I promise, I will be more careful in posting an issue.)
Comment #5
cilefen CreditAttribution: cilefen commentedComment #6
apadernoComment #7
Vivek Panicker CreditAttribution: Vivek Panicker at Innoraft for Drupal India Association commentedComment #8
Vivek Panicker CreditAttribution: Vivek Panicker at Innoraft for Drupal India Association commentedSubmitting a patch for the issue with the changes as mentioned.
Comment #10
Sivaji_Ganesh_Jojodae CreditAttribution: Sivaji_Ganesh_Jojodae as a volunteer and commentedNot sure how the Media_library test fail is relevant here. Patch looks straightforward. Retest requested.
Comment #11
apadernoThere should not be any comma after for example.
Comment #12
Vivek Panicker CreditAttribution: Vivek Panicker at Innoraft for Drupal India Association commentedI actually checked it online before submitting the patch.
Still I'll follow the suggestion you mentioned and update the patch.
Comment #13
Vivek Panicker CreditAttribution: Vivek Panicker at Innoraft for Drupal India Association commentedComment #14
Vivek Panicker CreditAttribution: Vivek Panicker at Innoraft for Drupal India Association commentedApologies for the mistake in the patch name.
Submitting the same updated patch with the correct name.
Comment #15
xjmAs 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!
Comment #16
Sivaji_Ganesh_Jojodae CreditAttribution: Sivaji_Ganesh_Jojodae as a volunteer and commentedThe 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?
Comment #17
Sivaji_Ganesh_Jojodae CreditAttribution: Sivaji_Ganesh_Jojodae as a volunteer and commentedComment #18
himanshu_sindhwani CreditAttribution: himanshu_sindhwani at Srijan | A Material+ Company for Drupal India Association commentedComment #19
apadernoI 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.
Comment #20
himanshu_sindhwani CreditAttribution: himanshu_sindhwani at Srijan | A Material+ Company for Drupal India Association commented+ '#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.
Comment #21
himanshu_sindhwani CreditAttribution: himanshu_sindhwani at Srijan | A Material+ Company for Drupal India Association commentedComment #22
Ruchi Joshi CreditAttribution: Ruchi Joshi at Srijan | A Material+ Company for Drupal India Association commentedI will apply patch and review this issue
Comment #23
Ruchi Joshi CreditAttribution: Ruchi Joshi at Srijan | A Material+ Company for Drupal India Association commented@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
Comment #26
vikashsoni CreditAttribution: vikashsoni as a volunteer and at Zyxware Technologies commentedapplied #14 patch applied successfully
thanks for the patch
For ref sharing screenshot....
Comment #27
kleiton_rodrigues CreditAttribution: kleiton_rodrigues at CI&T commentedpatch #14 applied successfully
LGTM moving to RTBC
Comment #28
bnjmnmRemoving 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.
Comment #29
anagomes CreditAttribution: anagomes at CI&T commentedComment #31
anagomes CreditAttribution: anagomes at CI&T commentedI 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.
Comment #32
apadernoThis 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.
Comment #33
apadernoThe text I suggested in the IS is unnecessarily long. I would suggest the following one.
(Alternatively, the following one is fine too, IMO.)
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.
Comment #34
andregp CreditAttribution: andregp at CI&T commentedComment #35
anagomes CreditAttribution: anagomes at CI&T commentedComment #36
anagomes CreditAttribution: anagomes at CI&T commentedHere's a patch based on what @apaderno said in #33.
Comment #37
ilgnerfagundes CreditAttribution: ilgnerfagundes at CI&T commentedpatch #36 successfully applied.
The message on the user screen was successfully changed, follow the evidence image, moving to rtbc
Comment #39
apadernoThe failures aren't related to this patch.
Comment #41
apadernoThe tests keep failing because this error.
Comment #42
apadernoComment #43
quietone CreditAttribution: quietone commentedStarting 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.
Comment #44
apadernoComment #46
vitorbs CreditAttribution: vitorbs at CI&T commentedI will try to work on this issue.
Comment #47
vitorbs CreditAttribution: vitorbs at CI&T commentedComment #48
apadernoComment #49
vitorbs CreditAttribution: vitorbs at CI&T commentedI did the changes suggested in the summary of the issue and changed the approach for easier review.
Comment #50
vitorbs CreditAttribution: vitorbs at CI&T commentedComment #51
apadernoThe text to use is the following one.
(I missed the period.)
The issue fork is using text that isn't suggested in the issue summary.
Comment #52
reenaraghavan CreditAttribution: reenaraghavan commentedComment #53
reenaraghavan CreditAttribution: reenaraghavan commentedComment #54
lucasscComment #55
lucasscHi!
I applied the patch in #36 and did the changes based on what @apaderno said in #51.
Please, review this.
Comment #56
sophiavs CreditAttribution: sophiavs at CI&T commentedHi, i will be doing the review
Comment #57
sophiavs CreditAttribution: sophiavs at CI&T commentedEverything looked fine for me, all the new user form with the message passed in #51
Comment #58
alexpottThis has not proved to be a quick fix :(
Comment #59
alexpottI 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!