Page MenuHomePhabricator

Show easy recommendations to beginners
Closed, ResolvedPublic2 Estimated Story Points

Description

To beginner translators on the target wiki (the wiki of the currently selected target language), show article and section translation recommendations that are defined as "easy" by the recommendation API.

Options to categorize user experience level include

  • Standard MediaWiki definitions of beginner and learner based on edit local count and days since account creation
  • global edit count

Derived Requirement

Update the recommendation system so that:

  • Beginner translators (on the target wiki) only see “easy” article and section recommendations as defined by the recommendation API.
  • Beginner status is determined using one of the following:
    • Standard MediaWiki definitions (based on local edit count and days since account creation).
    • Global edit count (as an alternative criteria).
  • Non-beginners continue to see the full range of recommendations (easy, medium, hard).
Test Steps

Test Case 1: Beginner User – Easy Recommendations Only

  1. Log in with a test account that qualifies as a beginner (low local edit count and recent account creation OR low global edit count).
  2. Navigate to article/section translation recommendations.
  3. ✅❓❌⬜ AC1: Only “easy” recommendations are displayed, no medium or hard recommendations appear.

Test Case 2: Experienced User – Full Recommendation Set

  1. Log in with a test account that exceeds beginner thresholds.
  2. Navigate to article/section translation recommendations.
  3. ✅❓❌⬜ AC2: Easy, medium, and hard recommendations are shown as normal.

QA Results - TestWiki

ACStatusDetails
1T399133#11215100
2T399133#11215100

Event Timeline

SBisson triaged this task as High priority.Jul 21 2025, 1:45 AM

@cchen (and maybe (@KCVelaga_WMF) what do you think is the definition of newcomers we should use here? Base solely on edits (global edits count) or should we consider how long ago they have made their account like in the user experience level filter in recent changes?

I'm leaning towards using the global edit count bucket for this purpose because this is already being logged and used in previous analysis so connections can be made between previous work and this hypothesis but I want to know what you think.

I agree that using the global edit count bucket makes sense.

ngkountas set the point value for this task to 2.Jul 30 2025, 1:40 PM

Change #1182213 had a related patch set uploaded (by Sbisson; author: Sbisson):

[mediawiki/extensions/ContentTranslation@master] Request "easy" suggestions from the rec api for newcomers

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

Change #1182213 merged by jenkins-bot:

[mediawiki/extensions/ContentTranslation@master] Request "easy" suggestions from the rec api for newcomers

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

Change #1186648 had a related patch set uploaded (by Sbisson; author: Sbisson):

[mediawiki/extensions/ContentTranslation@master] CX3 Build 1.0.0+20250909

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

Change #1186650 had a related patch set uploaded (by Sbisson; author: Sbisson):

[mediawiki/extensions/ContentTranslation@wmf/1.45.0-wmf.18] CX3 Build 1.0.0+20250909

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

Change #1186648 merged by jenkins-bot:

[mediawiki/extensions/ContentTranslation@master] CX3 Build 1.0.0+20250909

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

Change #1186650 merged by jenkins-bot:

[mediawiki/extensions/ContentTranslation@wmf/1.45.0-wmf.18] CX3 Build 1.0.0+20250909

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

Mentioned in SAL (#wikimedia-operations) [2025-09-10T13:54:25Z] <kartik@deploy1003> sbisson, kartik: Backport for [[gerrit:1186650|CX3 Build 1.0.0+20250909 (T374886 T394998 T399122 T399125 T399133 T403730 T404045 T404093)]] synced to the testservers (see https://wikitech.wikimedia.org/wiki/Mwdebug). Changes can now be verified there.

Mentioned in SAL (#wikimedia-operations) [2025-09-10T14:12:05Z] <kartik@deploy1003> Finished scap sync-world: Backport for [[gerrit:1186650|CX3 Build 1.0.0+20250909 (T374886 T394998 T399122 T399125 T399133 T403730 T404045 T404093)]] (duration: 24m 08s)

@SBisson Confirmed that it shows easy recommendations to beginners, as seen below. I will move this to Sign-off. Thanks for all your work!

Test Result - TestWiki

Status: ✅ PASS
Environment: TestWiki
OS: macOS Tahoe 26.0
Browser: Chrome 140
Device: MBA
Emulated Device: NA

Test Artifact(s):
https://en.wikipedia.org/w/api.php?action=query&meta=globaluserinfo&guiuser=GMikesell-WMF&guiprop=editcount&formatversion=2&origin=*&format=json
https://en.wikipedia.org/w/api.php?action=query&meta=globaluserinfo&guiuser=Georgemikesell&guiprop=editcount&formatversion=2&origin=*&format=json

Test Steps

Test Case 1: Beginner User – Easy Recommendations Only

  1. Log in with a test account that qualifies as a beginner (low local edit count and recent account creation OR low global edit count).
  2. Navigate to article/section translation recommendations.
  3. AC1: Only “easy” recommendations are displayed, no medium or hard recommendations appear.
Global Edit CountCX Rec API
2025-09-24_15-24-37.png (320×577 px, 37 KB)
2025-09-24_15-26-32.png (1×1 px, 213 KB)

Test Case 2: Experienced User – Full Recommendation Set

  1. Log in with a test account that exceeds beginner thresholds.
  2. Navigate to article/section translation recommendations.
  3. AC2: Easy, medium, and hard recommendations are shown as normal.
Global Edit CountCX Rec API
2025-09-24_15-08-10.png (329×552 px, 37 KB)
2025-09-24_15-24-01.png (1×1 px, 264 KB)
GMikesell-WMF updated the task description. (Show Details)
GMikesell-WMF moved this task from Needs QA to Design Signoff on the LPL Hypothesis board.