Page MenuHomePhabricator

Show aggregate section information with difficulty indicators in “Expand with new sections” list
Closed, ResolvedPublic8 Estimated Story Points

Description

The current section translation recommendations list shows article titles for which there are sections that can be added but let the user choose the section during the section selection step. We can promote easy sections with T399118: Add visual indicator to sections that are "easy" to translate during section selection step of the SX workflow but a more direct way to guide newcomers to easy sections may be to offer specific sections directly in the recommendation list. Similar to how new section to translate are presented on the published list.

Design directions

Based on usability testing, updating the approach to show aggregate section information with difficulty indicators.

Design specifications:

Current display: 13 sections
New display: 13 sections to translate(5 quick)

Visual treatment
image.png (900×1 px, 169 KB)
  • Base text: Default gray color (#54595d)
  • "(n quick)" portion: Green color (#177860)
  • Font weight: Regular for all text except (n quick) part which is bold.
  • Only show "(n quick)" when quick sections exist else only show "n sections to translate"
Acceptance criteria
  • Replace X sections with X sections to translate (Y quick) format
  • Quick section count uses same criteria as T399118

Derived Requirement

Update the section translation recommendations list to display aggregate section information with difficulty indicators:

  • Replace the current display format of section counts with “X sections to translate (Y quick)”.
  • If there are no quick sections, show only “X sections to translate”.
  • Apply the following visual treatment:
    • Base text in gray (#54595d).
    • “(Y quick)” portion in green (#177860) and bold.
    • Remaining text in regular font weight.
  • The count of quick sections must follow the criteria defined in T399118.
Test Steps

Test Case 1: Sections With Quick Options

  1. Navigate to the “Expand with new sections” recommendation list.
  2. Identify an article that has both regular and quick sections.
  3. ✅❓❌⬜ AC1: The list displays the format “X sections to translate (Y quick)”.
  4. ✅❓❌⬜ AC2: The “(Y quick)” portion is shown in green (#177860) and bold.
  5. ✅❓❌⬜ AC3: Quick section count matches the logic defined in T399118.

Test Case 2: Sections Without Quick Options

  1. Navigate to the “Expand with new sections” recommendation list for an article with no quick sections.
  2. ✅❓❌⬜ AC4: The list displays the format “X sections to translate”, without the quick portion.

QA Results - TestWiki

Event Timeline

ngkountas set the point value for this task to 8.Jul 17 2025, 1:46 PM
SBisson triaged this task as High priority.Jul 21 2025, 1:44 AM

Change #1172668 had a related patch set uploaded (by Nik Gkountas; author: Nik Gkountas):

[mediawiki/extensions/ContentTranslation@master] Suggestions: List easy section suggestions and add difficulty indicator

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

SBisson renamed this task from Show specific sections to translate in “Expand with new sections” list to Show aggregate section information with difficulty indicators in “Expand with new sections” list.Aug 21 2025, 12:13 PM
SBisson claimed this task.
SBisson moved this task from Prioritized to In-progress on the LPL Hypothesis board.

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

[mediawiki/extensions/ContentTranslation@master] Show number of easy section for recommendations in dashboard

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

Change #1180860 merged by jenkins-bot:

[mediawiki/extensions/ContentTranslation@master] Show number of easy section for recommendations in dashboard

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

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

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

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

Change #1181735 merged by jenkins-bot:

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

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

A comment about the "n quick" message (cx-sx-translation-suggestion-easy-sections): It appears to be shown in hard-coded parentheses. This is wrong for some languages, which use different parentheses characters. It's better to use the parentheses message from core, or to simply include the parentheses in the message itself.

A comment about the "n quick" message (cx-sx-translation-suggestion-easy-sections): It appears to be shown in hard-coded parentheses. This is wrong for some languages, which use different parentheses characters. It's better to use the parentheses message from core, or to simply include the parentheses in the message itself.

Thanks for the feedback. I'll make the change.

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

[mediawiki/extensions/ContentTranslation@master] Use 'parentheses' core msg instead of hardcoding ()

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

Pushing back to code review for the small fix above

Change #1184152 merged by jenkins-bot:

[mediawiki/extensions/ContentTranslation@master] Use 'parentheses' core msg instead of hardcoding ()

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

Change #1172668 abandoned by Nik Gkountas:

[mediawiki/extensions/ContentTranslation@master] Suggestions: List easy section suggestions and add difficulty indicator

Reason:

This was just a POC. Other patches, appropriate for production have already been merged to address the task requirements.

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

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 the update the section translation recommendations list to display aggregate section information with difficulty indicators, 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://test.wikipedia.org/w/index.php?title=Special:ContentTranslation&from=en&to=es&filter-type=automatic&filter-id=previous-edits&active-list=suggestions#/
https://cxserver.wikimedia.org/v2/suggest/sections/Last_Dinosaurs/en/es?include_section_sizes=true

Test Steps

Test Case 1: Sections With Quick Options

  1. Navigate to the “Expand with new sections” recommendation list.
  2. Identify an article that has both regular and quick sections.
  3. AC1: The list displays the format “X sections to translate (Y quick)”.

  1. AC2: The “(Y quick)” portion is shown in green (#177860) and bold.

2025-09-24_11-16-32.png (627×989 px, 161 KB)

  1. AC3: Quick section count matches the logic defined in T399118.

See AC1

Test Case 2: Sections Without Quick Options

  1. Navigate to the “Expand with new sections” recommendation list for an article with no quick sections.
  2. AC4: The list displays the format “X sections to translate”, without the quick portion.
W/O QuickSize Results
2025-09-24_11-20-20.png (849×860 px, 108 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.