Page MenuHomePhabricator

Consistently use "recommend" and "suggest" in GrowthExperiments messages
Open, LowestPublic

Description

At the moment, the GrowthExperiments extension uses the words "recommend" and "suggest" and their derivatives somewhat inconsistently.

"Recommend" is supposed to be said about something that the user should do. A user is supposed to have a good reason not to do it. For example, it makes sense to recommend adding an email address while signing up for an account.

"Suggest" is supposed to be said about things where the user has wider space to ponder and decide. So, an algorithm suggests adding a link, but this suggestion may be wrong, and the user is supposed to decide.

Some GrowthExperiments messages already use "suggest" about link suggestions, but some messages say "recommend". This should be consistent.

Here's a suggested patch to address this:
https://gerrit.wikimedia.org/r/c/mediawiki/extensions/GrowthExperiments/+/682248/1/i18n/homepage/en.json

Event Timeline

Restricted Application added a subscriber: Aklapper. · View Herald Transcript

Change 682248 had a related patch set uploaded (by Amire80; author: Amire80):

[mediawiki/extensions/GrowthExperiments@master] Replace some instances of "recommend" with "suggest"

https://gerrit.wikimedia.org/r/682248

As I understand it, based on the distinction you're drawing between recommending/suggesting, we are recommending (not just suggesting) links for the user to add to a page. These are links that an algorithm (from the link recommendation service) proposes to add to an article.

But this is for @RHo and @MMiller_WMF to decide on, I think.

As I understand it, based on the distinction you're drawing between recommending/suggesting, we are recommending (not just suggesting) links for the user to add to a page. These are links that an algorithm (from the link recommendation service) proposes to add to an article.

But this is for @RHo and @MMiller_WMF to decide on, I think.

Given that there are also several messages that implore the user to explore the link and make sure that the suggestion is correct and also provide examples of possible bad links, that's definitely not a recommendation.

As I understand it, based on the distinction you're drawing between recommending/suggesting, we are recommending (not just suggesting) links for the user to add to a page. These are links that an algorithm (from the link recommendation service) proposes to add to an article.

But this is for @RHo and @MMiller_WMF to decide on, I think.

Given that there are also several messages that implore the user to explore the link and make sure that the suggestion is correct and also provide examples of possible bad links, that's definitely not a recommendation.

Hi @Amire80 - thanks for taking a close review of the copy! I agree about using "suggestions" instead of "recommendations". It looks like the one instance of "recommendation" that appears in the copy (Links are recommended by machine, and {{GENDER:$1|you}} will decide whether to add them to the article.) was an oversight so happy to change to Links are suggested by machine instead.
The other items appear to be field names that are not visible in the UI so will leave that for @kostajh and other engineers to consider.

As I understand it, based on the distinction you're drawing between recommending/suggesting, we are recommending (not just suggesting) links for the user to add to a page. These are links that an algorithm (from the link recommendation service) proposes to add to an article.

But this is for @RHo and @MMiller_WMF to decide on, I think.

Given that there are also several messages that implore the user to explore the link and make sure that the suggestion is correct and also provide examples of possible bad links, that's definitely not a recommendation.

Hi @Amire80 - thanks for taking a close review of the copy! I agree about using "suggestions" instead of "recommendations". It looks like the one instance of "recommendation" that appears in the copy (Links are recommended by machine, and {{GENDER:$1|you}} will decide whether to add them to the article.) was an oversight so happy to change to Links are suggested by machine instead.

Thanks!

The other items appear to be field names that are not visible in the UI so will leave that for @kostajh and other engineers to consider.

It looks like some of them are logs or error messages. Messages that appear in on-wiki logs are visible in the UI—wiki administrators check the logs quite frequently.

Those that are very technical, and can only be seen by tool developers, can perhaps be moved to the API to help translatewiki volunteers prioritize things.

If there are any messages that are never seen in translation, for example if they are only used in server logs that only extension developers look at, they shouldn't be translated at all, and should be defined as ignored. I can do it, but you'll have to tell me what their keys are.

In any case, the text should use these words consistently even if only a few people see them.

kostajh triaged this task as Lowest priority.Apr 26 2021, 7:52 PM
kostajh added a project: Add-Link.

@RHo -- I agree that we should change that one instance of "recommend" to "suggest" in the UI. I'm putting this in the "improvements" epic.

@RHo -- I agree that we should change that one instance of "recommend" to "suggest" in the UI. I'm putting this in the "improvements" epic.

@MMiller_WMF there's already a patch that's 99% complete, so I think we should merge it when it's done. We could do another review of wording in the improvementsh epic.

Change 682248 merged by jenkins-bot:

[mediawiki/extensions/GrowthExperiments@master] Replace some instances of "recommend" with "suggest"

https://gerrit.wikimedia.org/r/682248