Page MenuHomePhabricator

Suggested Edits: Recommender Systems documentation should be linked from Home
Closed, ResolvedPublic2 Estimated Story Points

Description

User story & summary:

As someone visiting my Home, I want to understand how Suggested Edits recommendations are generated, so that I know how I can control, adjust, or opt out of them.
And, ideally, so I can feel reassured that Wikipedia remains a lovely beacon of hope on the internet: transparent about how things work and respectful of my choices.

Background & research:

This task is important because we should be transparent about how our features work and make it clear that account holders have control over Recommendations.

It is also part of our recommender system compliance checklist, which includes requirements around transparency. In other words, this is both a good product practice and one of those rare occasions when Legal and UX are asking us to do the same thing.

Design:

CleanShot 2026-10-12 at 12.04.29.png (2,528×1,698 px, 510 KB)

figma deep link: https://www.figma.com/design/KJUU0vNeKwPhVd9K05qpCr/T419358-Home?node-id=1605-10778&t=lAZR9CTnnxrvgyhL-1

Acceptance Criteria:

Given I am on Home on desktop or mobile
When I want to learn more about Suggested Edits,
Then I can tap on the ... menu and navigate to "About suggested edits" and then tap on the word "Recommendations" to learn more.

Event Timeline

Noting that in T433725 we are adding a link to this page in a Review Changes-specific info icon, which pops up information about how we're personalising the feed and includes a 'learn more' link leading to this page.

I wonder if we should keep adding it in module-specific guidance like this, for the modules which are personalised, or if it should be linked somewhere at the Home level, applying to all content in the experience.

FYI @OTichonova.

Michael triaged this task as High priority.Sep 30 2026, 3:41 PM

For the pilot Home launch, we’ll keep recommendations module-specific as the way we recommend content will vary module to module.

  • Review changes - the recommender system page is linked from the "Learn more" link under the three dots -> in the "Personalization" description. T433725
  • Suggested edits - After speaking with @AAlhazwani-WMF, the link for Suggested edits will probably be under the three dots -> in the "About Suggested edits" text.
  • Suggested edits - After speaking with @AAlhazwani-WMF, the link for Suggested edits will probably be under the three dots -> in the "About Suggested edits" text.

correct! here's our proposal cc @KStoller-WMF

CleanShot 2026-10-12 at 12.04.29.png (2,528×1,698 px, 510 KB)

figma deep link: https://www.figma.com/design/KJUU0vNeKwPhVd9K05qpCr/T419358-Home?node-id=1605-10778&t=lAZR9CTnnxrvgyhL-1

KStoller-WMF renamed this task from Recommender Systems documentation should be linked from Home to Suggested Edits: Recommender Systems documentation should be linked from Home.Wed, Oct 14, 5:27 PM
KStoller-WMF updated the task description. (Show Details)
Sgs set the point value for this task to 2.
Sgs edited projects, added: Growth-Team (FY2026-27 Q2 Sprint 1); removed: Growth-Team.
Sgs moved this task from Incoming to Doing on the Growth-Team (FY2026-27 Q2 Sprint 1) board.

Change #1355600 had a related patch set uploaded (by Sergio Gimeno; author: Sergio Gimeno):

[mediawiki/extensions/GrowthExperiments@master] PersonalDashboard: Link the recommender system documentation

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

Adding some maybe irrelevant implementation differences between SuggestedEdits and Review changes:

  1. Review changes link URL is handled as translation message (has to be translated to each wiki) and links to https://www.mediawiki.org/wiki/Home/Recommendations#Review_Changes. The anchor is stable but if the page is translated it still points to the main version (en), no Special:MyLanguage. SuggestedEdit version also avoids MyLanguage for anchor stability avoids the anchor for stability and uses Special:MyLanguage. It stores the URL in a MW config variable.
  2. The UX is different per spec from “Review changes” module in PersonalDashboard. In Review changes, the learn more link is only shown in the personalisation dialog ("Learn more") rather than in the menu item “About $moduleName”. Only miss-leading for users that would use both modules and that's unlikely (?) so maybe establishing a pattern isn't worth.

Given some of this link may have legal implications maybe it would be good to establish some pattern for discovery and/or add some guards to make sure they are stable.

I think there's some sense in being consistent between the modules, for familiarity. @OTichonova @AAlhazwani-WMF do you think you could come to an agreement on #2 above? Happy to adjust Review Changes if necessary!

Change #1355600 merged by jenkins-bot:

[mediawiki/extensions/GrowthExperiments@master] PersonalDashboard: Link the recommender system documentation

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

@Sgs is it possible to have some placeholder copy so that the translation keys aren't all that's displayed in Beta? This is what I currently see when I test on device.

Screenshot_20261016_143747_Chrome.jpg (1,080×2,340 px, 328 KB)

After chatting with Sergio about the issue, it turned out to be a stale cache. Hard refreshing shows this.

I see that the recommender systems documentation is set from config which is a plus.

The tasks scope appears done

Screenshot_20261016_151614_Chrome.jpg (1,080×2,340 px, 430 KB)

After chatting with Sergio about the issue, it turned out to be a stale cache. Hard refreshing shows this.

I see that the recommender systems documentation is set from config which is a plus.

The tasks scope appears done

Screenshot_20261016_151614_Chrome.jpg (1,080×2,340 px, 430 KB)

a clarification: the external icon is becuase this has been tested on beta, right? it won't show in prod, or?

Good question. We'll have to wait until this lands on testwiki to see. I'll move it to test in production for testwiki verification

I think there's some sense in being consistent between the modules, for familiarity. @OTichonova @AAlhazwani-WMF do you think you could come to an agreement on #2 above? Happy to adjust Review Changes if necessary!

to your question @Samwalton9-WMF, olga and i chatted about this while designing the respective flows. and for now we feel okay about keeping the two approaches different. even if they differ, they are more semantically correct.

in suggested edits, personalization is spread across two menu items (interests and types of edits). no single item owns “personalization” so about is the one neutral place that can explain how those two inputs combine into recommendations. in review changes, personalization is a single on/off setting with its own sheet, so the link sits right next to the control it explains.

what we could do (in a follow up task?) is the following:

  • use one link pattern in both modules. so replace “learn more” with an inline “[recommendations] are based on…” sentence, matching suggested edits sheet
  • match the menu label with sheet title, so rename “personalize review changes” to “personalization”
  • add a status line to the personalization menu item (“on” or “off”), mirroring “1 selected” and “2 selected” from the suggested edits menu
  • align the terminology in the review changes about sheet, so use “changes” instead of “edits” in active voice: “other editors made these changes. reviewing them helps maintain wikipedia’s quality.”

After chatting with Sergio about the issue, it turned out to be a stale cache. Hard refreshing shows this.

I see that the recommender systems documentation is set from config which is a plus.

The tasks scope appears done

Screenshot_20261016_151614_Chrome.jpg (1,080×2,340 px, 430 KB)

a clarification: the external icon is becuase this has been tested on beta, right? it won't show in prod, or?

It will show in production. Minerva is adding it. The external icon is added by core's client message parser in resources/src/mediawiki.jqueryMsg/mediawiki.jqueryMsg.js:1204, which adds class="external" to any bracketed link whose target isn't a local article path. Then Minerva adds a background-image for it. The icon is arguably correct, but I think we should be able to easily opt-out from it.

Hmm, somehow we were able to have ours not include the external link icon:

Screenshot 2026-10-20 at 11.30.55.png (1,532×822 px, 211 KB)

See T433725 for the patch.

Hmm, somehow we were able to have ours not include the external link icon:

Screenshot 2026-10-20 at 11.30.55.png (1,532×822 px, 211 KB)

See T433725 for the patch.

i think that's because you're looking at the desktop/vector22 skin, or?

After chatting with Sergio about the issue, it turned out to be a stale cache. Hard refreshing shows this.

I see that the recommender systems documentation is set from config which is a plus.

The tasks scope appears done

Screenshot_20261016_151614_Chrome.jpg (1,080×2,340 px, 430 KB)

a clarification: the external icon is becuase this has been tested on beta, right? it won't show in prod, or?

It will show in production. Minerva is adding it. The external icon is added by core's client message parser in resources/src/mediawiki.jqueryMsg/mediawiki.jqueryMsg.js:1204, which adds class="external" to any bracketed link whose target isn't a local article path. Then Minerva adds a background-image for it. The icon is arguably correct, but I think we should be able to easily opt-out from it.

thanks @Sgs, let's opt-out then!

Oh, you're right, it's there in mobile view.

Screenshot 2026-10-20 at 14.27.20.png (992×386 px, 50 KB)

Change #1357516 had a related patch set uploaded (by Sergio Gimeno; author: Sergio Gimeno):

[mediawiki/extensions/GrowthExperiments@master] SuggestedEdits: hide the external icon on the recommendations link

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

Change #1357516 merged by jenkins-bot:

[mediawiki/extensions/GrowthExperiments@master] SuggestedEdits: hide the external icon on the recommendations link

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

Etonkovidova subscribed.

Checked on testwiki wnf.3

  • the external link icon is not present anymore - not in minerva nor in Vector-2022
  • the screenshots below are from a real device iPhone 11
IMG_9224.PNG (828×1,792 px, 353 KB)
IMG_9223.PNG (296×640 px, 268 KB)
IMG_9222.PNG (828×1,792 px, 272 KB)

I also checked for clickable areas for three-dot button and x button - seems to be ok.

Note:

  • on Special:Homepage the Suggeted edits module has much more info about
    • explanation aboutsuggested edits, filtering by topic, task types recommendations and a specific type of task explanation

Screenshot 2026-11-05 at 4.00.57 PM.png (1,688×1,560 px, 705 KB)