Problem/Motivation

The verb "click" is not inclusive. Many users interact with links without clicking them.

From #85494-330: Use email verification when changing user email addresses:

I noticed that many of the email templates reference "clicking" a link rather than "using" or "following" (or some other term that would encompass both a click and a tap).

Steps to reproduce

Generate a password-reset e-mail. It will (by default) include the text

You may now log in by clicking this link or copying and pasting it into your browser:

[user:one-time-login-url]

(with the token replaced). Or, logged in as an administrator, you can see that text in the Emails section of /admin/config/people/accounts.

Proposed resolution

Update the text to use more inclusive terms, such as "follow".

Remaining tasks

User interface changes

To be determined (TBD)

API changes

None

Data model changes

None

Release notes snippet

Not needed

Issue fork drupal-3265073

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:

Comments

benjifisher created an issue. See original summary.

cilefen’s picture

The verb "click" is not inclusive.

The word is also just a but silly, when at the very least 50% of web usage is on touch devices.

rootwork’s picture

I opened the referenced meta-issue some time ago, but it hasn't gotten any interest. I don't suggest it here to be a blocker on this, but to anyone who thinks "click" is strange in the email text, let's talk about establishing a policy on its use throughout Drupal too.

benjifisher’s picture

Personally, I avoid using "click". (I stay very far away from "click here".) I checked the Interface text guidelines, hoping that I could find an official policy about it, but all it says is,

Make sure link text describes what is on the linked page or what will happen if the link is clicked

Do not use "Click Here" or a URL for a link text

and then, in the sidebar,

Log in, click Edit, and edit this page
Log in, click Discuss, ...

I also asked on the #accessibility channel in Slack. So far, two responses:

  • You may be over-thinking it (paraphrase)
  • "I like to use the word 'activate' when writing documentation. It is accurate and inclusive."

So I guess that there are different opinions.

aaronmchale’s picture

Our User Interface Standards already advise against the use of "click here" links:

Do not use "Click Here" or a URL for a link text

User interface standards: Interface text

So it's already in policy, we just need to get on with it.

benjifisher’s picture

@AaronMcHale:

You quoted part of the same excerpt that I quoted in #4.

Everyone agrees not to use "click here" for link text. This issue is about avoiding the verb "click", as in

You need to verify the change by clicking on the link below or copying and pasting it in your browser ...

My opinion is that we should not use "clicking" in that e-mail. But the guidelines for interface text say,

Make sure link text describes what is on the linked page or what will happen if the link is clicked

(emphasis added). So it seems that not everyone agrees with me.

aaronmchale’s picture

@AaronMcHale:

You quoted part of the same excerpt that I quoted in #4.

Ahh whoops, clearly I need to pay more attention to previous comments :D

My opinion is that we should not use "clicking" in that e-mail. But the guidelines for interface text say,

Make sure link text describes what is on the linked page or what will happen if the link is clicked

(emphasis added). So it seems that not everyone agrees with me.

I agree we should avoid "clicking" as well, "follow"/"following" would work well. We probably need a separate issue to discuss rewording that sentence of the Interface Text, I would suggest something like "... what will happen when the link is followed".

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.

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

Drupal 9.5.0-beta2 and Drupal 10.0.0-beta2 were released on September 29, 2022, which means new developments and disruptive changes should now be targeted for the 10.1.x-dev branch. For more information see the Drupal core minor version schedule and the Allowed changes during the Drupal core release cycle.

no sssweat’s picture

"follow"/"following" would work well.

Hmm... that sounds weird to me because of social media.

In my opinion, it be better to say, please "visit" or "go to".

Version: 10.1.x-dev » 11.x-dev

Drupal core is moving towards using a “main” branch. As an interim step, a new 11.x branch has been opened, as Drupal.org infrastructure cannot currently fully support a branch named main. New developments and disruptive changes should now be targeted for the 11.x branch, which currently accepts only minor-version allowed changes. For more information, see the Drupal core minor version schedule and the Allowed changes during the Drupal core release cycle.

meeni_dhobale made their first commit to this issue’s fork.

quietone’s picture

Title: Re-word all admin e-mails to remove "click" » Re-word all admin emails to remove "click"

Version: 11.x-dev » main

Drupal core is now using the main branch as the primary development branch. New developments and disruptive changes should now be targeted to the main branch.

Read more in the announcement.