Page MenuHomePhabricator

Banners on old/new dashboards about upcoming transition
Closed, ResolvedPublic

Assigned To
Authored By
SBisson
Feb 11 2025, 4:32 PM
Referenced Files
F58937467: 2025-03-28_16-04-42.mp4.gif
Mar 28 2025, 11:36 PM
F58937465: 2025-03-28_16-01-45.mp4.gif
Mar 28 2025, 11:36 PM
F58937494: 2025-03-28_16-24-50.mp4.gif
Mar 28 2025, 11:36 PM
F58937492: 2025-03-28_16-22-43.mp4.gif
Mar 28 2025, 11:36 PM
F58937489: 2025-03-28_16-21-35.mp4.gif
Mar 28 2025, 11:36 PM
F58937483: 2025-03-28_16-09-34.png
Mar 28 2025, 11:36 PM
F58937481: 2025-03-28_16-21-35.mp4.gif
Mar 28 2025, 11:36 PM
F58937475: 2025-03-28_16-20-30.mp4.gif
Mar 28 2025, 11:36 PM

Description

This ticket proposes to include a banner in the translation dashboard in order to minimize the impact of unexpected regressions. It is intended to serve the following purposes:

  • Let users know that the dashboard was updated, and it comes with new features.
  • Provide alternatives in case users face unexpected issues that would block their work otherwise.

Proposed solution

In order to achieve this, this ticket proposes changes to both, the old version of the desktop dashboard and the unified dashboard when accessed on desktop. Below, you can see mockups illustrating the proposed changes (check in Figma):

Unified dashboardOld desktop dashboard
Desktop - Unified Banner.png (900×1 px, 120 KB)
Desktop - Deprecated Banner.png (900×1 px, 134 KB)

Design details

Unified dashboard on desktop (and only on desktop):

  • A banner in the style of the "experimental banner" from T270501 will be shown.
  • An option to access the old dashboard will be added to the "Need help translating?" panel.

The banner uses the IconLabFlask icon form Codex and the following contents:

New capabilities available

Translate individual sections, adjust suggestions to your topics of interest, and more. Previously only on mobile, now available across all devices.
[Learn more]
[Access the previous version]

At the "Need help translating?" panel, a new "Access the previous version" option will be added, using also the IconLabFlask icon. That will switch the user to the old dashboard.

Old dashboard

  • A banner in the style of a Codex warning message will be shown.
  • An option to access the new unified dashboard will be added to the "Need help translating?" panel.

The banner uses the Alert icon form Codex and the following contents:

The current dashboard version will be deprecated soon. Please, [use the new version] and [report any issues] you may find.

Additional considerations

  • The purpose of the unified dashboard is to provide a single dashboard for users. This temporary period is an exceptional measure to avoid breaking the current workflow from users. Having two versions results in fragmentation, and we want to keep this temporary period as short a possible.
  • We may want to update the project pages to mention some of the relevant changes.

Derived Requirement

Ensure that banners are displayed on both the old and new translation dashboards to inform users about the transition and provide access to alternative versions and support resources.

  • Unified dashboard (desktop only):
    • Display an "experimental banner" informing users about new capabilities.
    • Provide options to access the old dashboard via the "Need help translating?" panel.
    • Include "Learn more" and "Access the previous version" links with the correct destinations.
  • Old desktop dashboard:
    • Display a warning banner about the upcoming deprecation.
    • Provide an option to access the new unified dashboard in the "Need help translating?" panel.
    • Ensure "use the new version" and "report any issues" links function correctly.
Test Steps

Test Case 1: Verify Banner Display on Unified Dashboard (Desktop)

  1. Navigate to the unified translation dashboard on a desktop device.
  2. Check if the "New capabilities available" banner is displayed.
  3. ✅❓❌⬜ AC1: The banner should appear with the correct text and the IconLabFlask icon.

Test Case 2: Verify Banner Links on Unified Dashboard (Desktop)

  1. Click the "Learn more" link.
  2. ✅❓❌⬜ AC2: The link should redirect to the Content Translation project page.

Test Case 3: Verify 'Need Help Translating?' Panel on Unified Dashboard (Desktop)

  1. Locate the "Need help translating?" panel.
  2. Click the "Access the previous version" option.
  3. ✅❓❌⬜ AC3: The user should be switched to the old dashboard.

Test Case 4: Verify Banner Display on Old Dashboard (Desktop)

  1. Navigate to the old translation dashboard on a desktop device.
  2. Check if the warning banner is displayed.
  3. ✅❓❌⬜ AC4: The banner should appear with the correct text and the Alert icon.

Test Case 5: Verify Banner Links on Old Dashboard (Desktop)

  1. Click the "use the new version" link.
  2. ✅❓❌⬜ AC5: The link should enable the new version of the dashboard.
  3. Click the "report any issues" link.
  4. ✅❓❌⬜ AC6: The link should redirect to the Content Translation talk page.

Test Case 6: Verify 'Need Help Translating?' Panel on Old Dashboard (Desktop)

  1. Locate the "Need help translating?" panel.
  2. Click the "use the new version" option.
  3. ✅❓❌⬜ AC7: The user should be switched to the new unified dashboard.

QA Results - Test Wiki

Event Timeline

ngkountas moved this task from Backlog to Prioritized on the LPL Hypothesis board.

@Pginer-WMF about the IconLabFlask icon, do we want to send the "experimental" or "new and improved" message?

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

[mediawiki/extensions/ContentTranslation@master] Banners on old and new dashboards

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

@Pginer-WMF about the IconLabFlask icon, do we want to send the "experimental" or "new and improved" message?

Good call. On first look, I was not finding an appropriate icon for "updates" but the "experimental" connotation is sending a contradicting message. I tried SpecialPages and it may provide a good compromise:

Unified dashboardOld desktop dashboard
Desktop - Unified Banner.png (900×1 px, 120 KB)
Desktop - Deprecated Banner.png (900×1 px, 134 KB)

Visually can be interpreted as versions with new stuff (the sparks). Semantically, it is not the best fit, but it is not contradictory since a special page is representing tools with specific functionality.

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

[mediawiki/extensions/ContentTranslation@master] Dashboard banners: messages

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

Change #1120584 merged by jenkins-bot:

[mediawiki/extensions/ContentTranslation@master] Dashboard banners: messages

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

Change #1120232 merged by jenkins-bot:

[mediawiki/extensions/ContentTranslation@master] Banners on old and new dashboards

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

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

[mediawiki/extensions/ContentTranslation@master] CX3 Build 0.2.0+20250224

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

Change #1122111 merged by jenkins-bot:

[mediawiki/extensions/ContentTranslation@master] CX3 Build 0.2.0+20250224

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

Looking at the current state of the dashboard on Test Wiki I noticed that the option to access the previous/new version from the "Need help translating?" panel was not showing:

CurrentExpected
test.wikipedia.org_w_index.php_title=Special_ContentTranslation&filter-type=collections&filter-id=Wiki99%2Ffood&active-list=suggestions&from=en&to=ig(Wiki Desktop).png (900×1 px, 186 KB)
Desktop - Unified Banner (1).png (900×1 px, 151 KB)

@Pginer-WMF the link to switch dashboard from the "need help translating?" panel was missed from the initial patch. I will add it now.

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

[mediawiki/extensions/ContentTranslation@master] Unified dashboard: add link to old dashboard in help panel

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

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

[mediawiki/extensions/ContentTranslation@master] Desktop dashboard: add help panel link to new dashboard

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

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

[mediawiki/extensions/ContentTranslation@master] Dashboard banners: link to canonical Special:ContentTranslation

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

Change #1122663 merged by jenkins-bot:

[mediawiki/extensions/ContentTranslation@master] Unified dashboard: add link to old dashboard in help panel

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

Change #1122669 merged by jenkins-bot:

[mediawiki/extensions/ContentTranslation@master] Desktop dashboard: add help panel link to new dashboard

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

Change #1122956 merged by jenkins-bot:

[mediawiki/extensions/ContentTranslation@master] Dashboard banners: link to canonical Special:ContentTranslation

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

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

[mediawiki/extensions/ContentTranslation@master] CX3 Build 0.2.0+20250303

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

Change #1124141 merged by jenkins-bot:

[mediawiki/extensions/ContentTranslation@master] CX3 Build 0.2.0+20250303

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

The fixes have now been deployed in test wiki, and the banner along with the links in the "Need help translating?" panel are properly displayed in both the old and the unified dashboard:

  • The banners are displayed every time after refresh
  • The cx-dashboard URL parameter is properly set
  • The banners are not displayed on mobile

Note: The changes on old dashboard cannot yet be tested on production wikis because the ContentTranslationEnableUnifiedDashboard configuration parameter is not set to true yet.

Screencast from test wiki:

The fixes have now been deployed in test wiki, and the banner along with the links in the "Need help translating?" panel are properly displayed in both the old and the unified dashboard:

  • The banners are displayed every time after refresh
  • The cx-dashboard URL parameter is properly set
  • The banners are not displayed on mobile

Overall looks good. However, there is a particular case when the premise to apply the changes "on desktop (and only on desktop)" breaks:
Switching to the old version on desktop, results in the old desktop version of the dashboard being shown also when accessing on mobile. This leads to a broken experience on mobile.

In the video below, I captured the issue using two windows: desktop (left) and mobile (right):

The steps to reproduce:

  1. Access the desktop version.
  2. Select the option to "Access the previous version"
  3. Switch to the mobile version (refresh if it was already opened)
  4. Observe how the mobile shows the old desktop dashboard banner, and it is not possible to start a translation.

The expected behavior would be for the mobile experience to always use the unified dashboard, regardless of the version used on the desktop. If it were easier to implement, we can consider even making the access to the mobile version to enable the unified dashboard (i.e., accessing the mobile version could be equivalent to pressing the "Access new version" button).

Moving it back to in-progress, but we can create a separate ticket and mark this one as done if preferred.

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

[mediawiki/extensions/ContentTranslation@master] For wikis in transition, mobile site always gets unified dashboard

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

Change #1127623 merged by jenkins-bot:

[mediawiki/extensions/ContentTranslation@master] For wikis in transition, mobile site always gets unified dashboard

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

@SBisson Confirmed that the transitions of Banners on old/new dashboards as designed as seen in the gifs/screenshots. I will move this to sign-off. Thanks for all your work!

Test Result - Teste Wiki

Status: ✅ PASS
Environment: Teste Wiki
OS: macOS Sequoia 15.4
Browser: Chrome 134
Device: MBA
Emulated Device: NA

Test Artifact(s):

Test Steps

Test Case 1: Verify Banner Display on Unified Dashboard (Desktop)

  1. Navigate to the unified translation dashboard on a desktop device.
  2. Check if the "New capabilities available" banner is displayed.
  3. AC1: The banner should appear with the correct text and the IconLabFlask icon.

2025-03-28_16-09-47.png (994×1 px, 277 KB)

Test Case 2: Verify Banner Links on Unified Dashboard (Desktop)

  1. Click the "Learn more" link.
  2. AC2: The link should redirect to the Content Translation project page.
  3. Click the "Access the previous version" link.

2025-03-28_16-20-30.mp4.gif (778×1 px, 1 MB)

Test Case 3: Verify 'Need Help Translating?' Panel on Unified Dashboard (Desktop)

  1. Locate the "Need help translating?" panel.
  2. Click the "Access the previous version" option.
  3. AC3: The user should be switched to the old dashboard.

2025-03-28_16-21-35.mp4.gif (872×1 px, 1 MB)

Test Case 4: Verify Banner Display on Old Dashboard (Desktop)

  1. Navigate to the old translation dashboard on a desktop device.
  2. Check if the warning banner is displayed.
  3. AC4: The banner should appear with the correct text and the Alert icon.

2025-03-28_16-09-34.png (996×1 px, 284 KB)

Test Case 5: Verify Banner Links on Old Dashboard (Desktop)

  1. Click the "use the new version" link.
  2. AC5: The link should enable the new version of the dashboard.

2025-03-28_16-21-35.mp4.gif (872×1 px, 1 MB)

  1. Click the "report any issues" link.
  2. AC6: The link should redirect to the Content Translation talk page.

2025-03-28_16-22-43.mp4.gif (1×1 px, 1 MB)

Test Case 6: Verify 'Need Help Translating?' Panel on Old Dashboard (Desktop)

  1. Locate the "Need help translating?" panel.
  2. Click the "use the new version" option.
  3. AC7: The user should be switched to the new unified dashboard.

2025-03-28_16-24-50.mp4.gif (786×1 px, 696 KB)

T386118#10604901

2025-03-28_16-01-45.mp4.gif (1×1 px, 1 MB)

T386118#10604787

2025-03-28_16-04-42.mp4.gif (986×1 px, 2 MB)

Great! The issue described in T386118#10604901 is no longer happening.