Page MenuHomePhabricator

Improve placement of the onboarding dialog
Closed, ResolvedPublic1 Estimated Story Points

Assigned To
Authored By
aude
Oct 21 2025, 9:14 PM
Referenced Files
F68449381: screenshot 335.png
Oct 30 2025, 3:23 AM
F68449369: screenshot 334.png
Oct 30 2025, 3:23 AM
F68449349: screenshot 333.png
Oct 30 2025, 3:23 AM
F68449307: screenshot 332.png
Oct 30 2025, 3:23 AM
F68449295: screenshot 331.png
Oct 30 2025, 3:23 AM
F68449240: screenshot 330.png
Oct 30 2025, 3:23 AM
F68448435: screenshot 329.png
Oct 30 2025, 3:20 AM
F68448383: screenshot 328.png
Oct 30 2025, 3:20 AM

Description

On larger screens, the onboarding dialog is positioned off to the side with the arrow on the left side of the popover, anchoring to the bookmark element. The placement option for the Popover is set to "bottom-start" which causes this behavior.

Screenshot 2025-10-21 at 4.56.31 PM.png (1×2 px, 166 KB)

"bottom-end" for the placement would place the arrow on the right side of the popover (for LTR) languages.

With this change:

Screenshot 2025-10-21 at 5.09.55 PM.png (1×2 px, 176 KB)

Requirement

Scope: Desktop web (Vector 2022).

  • Adjust the placement of the Reading List onboarding dialog to improve alignment on larger screens.
  • Update the popover placement from "bottom-start" to "bottom-end" for LTR languages so that:
    • The arrow anchors to the right side of the popover, aligning correctly with the bookmark icon.
    • The dialog appears closer and visually aligned with the bookmark element.
  • Ensure RTL languages mirror the placement appropriately (use "bottom-start" for RTL).
  • The dialog must remain responsive and properly aligned across all viewport widths.

BDD

Feature: Improve placement of onboarding dialog on large screens

  Scenario: Onboarding dialog alignment for LTR languages
    Given I am using Vector 2022 on a large screen with LTR language (e.g., English)
    When the onboarding dialog appears
    Then the popover arrow anchors on the right side
    And the dialog is positioned correctly near the bookmark icon

  Scenario: Onboarding dialog alignment for RTL languages
    Given I am using Vector 2022 on a large screen with RTL language (e.g., Arabic)
    When the onboarding dialog appears
    Then the popover arrow anchors on the left side
    And the dialog remains properly aligned with the bookmark icon

Test Steps

Test Case 1: Verify onboarding dialog placement in LTR

  1. Log in with Reading Lists enabled.
  2. Load an article with the Save (bookmark) icon visible on a large screen.
  3. Trigger the onboarding dialog to appear.
  4. AC1: The popover arrow appears on the right side of the dialog (placement = "bottom-end").
  5. AC2: The dialog aligns correctly with the bookmark icon and does not appear off to the side.

Test Case 2: Verify onboarding dialog placement in RTL

  1. Switch interface language to an RTL language (e.g., Arabic or Hebrew).
  2. Reload the article page and trigger the onboarding dialog.
  3. AC3: The popover arrow appears on the left side of the dialog (placement = "bottom-start").
  4. AC4: The dialog aligns properly with the bookmark icon and maintains correct spacing.

QA Results - Beta

QA Results - Prod

Event Timeline

aude renamed this task from Improve positioning of the onboarding dialog to Improve placement of the onboarding dialog.Oct 21 2025, 9:15 PM

Change #1197719 had a related patch set uploaded (by Aude; author: Aude):

[mediawiki/extensions/ReadingLists@master] styles: Improve placement of the onboarding dialog

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

Change #1197719 merged by jenkins-bot:

[mediawiki/extensions/ReadingLists@master] styles: Improve placement of the onboarding dialog

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

And into QA - someone who cares more than me can figure out the pointing calculus, but leaving it untouched for now

aude set the point value for this task to 1.Oct 22 2025, 6:15 PM
HFan-WMF triaged this task as Medium priority.Oct 28 2025, 7:05 PM
Edtadros subscribed.

Test Result - Beta

Status: ✅ PASS
Environment: beta
OS: macOS Tahoe 26.x
Browser: Chrome Canary (latest as of test date)
Device: MS
Emulated Device: NA

Test Case 1: Verify onboarding dialog placement in LTR

  1. Log in with Reading Lists enabled.
  2. Load an article with the Save (bookmark) icon visible on a large screen.
  3. Trigger the onboarding dialog to appear.
  4. AC1: The popover arrow appears on the right side of the dialog (placement = "bottom-end").
  5. AC2: The dialog aligns correctly with the bookmark icon and does not appear off to the side.
screenshot 324.png (1×2 px, 847 KB)
screenshot 325.png (1×2 px, 794 KB)
screenshot 326.png (1×2 px, 441 KB)

Test Case 2: Verify onboarding dialog placement in RTL

  1. Switch interface language to an RTL language (e.g., Arabic or Hebrew).
  2. Reload the article page and trigger the onboarding dialog.
  3. AC3: The popover arrow appears on the left side of the dialog (placement = "bottom-start").
  4. AC4: The dialog aligns properly with the bookmark icon and maintains correct spacing.
screenshot 327.png (1×2 px, 928 KB)
screenshot 328.png (1×2 px, 928 KB)
screenshot 329.png (1×2 px, 591 KB)

Test Result - Prod

Status: ✅ PASS
Environment: testwiki
OS: macOS Tahoe 26.x
Browser: Chrome Canary (latest as of test date)
Device: MS
Emulated Device: NA

Test Case 1: Verify onboarding dialog placement in LTR

  1. Log in with Reading Lists enabled.
  2. Load an article with the Save (bookmark) icon visible on a large screen.
  3. Trigger the onboarding dialog to appear.
  4. AC1: The popover arrow appears on the right side of the dialog (placement = "bottom-end").
  5. AC2: The dialog aligns correctly with the bookmark icon and does not appear off to the side.
screenshot 330.png (1×2 px, 688 KB)
screenshot 331.png (1×2 px, 672 KB)
screenshot 332.png (1×2 px, 515 KB)

Test Case 2: Verify onboarding dialog placement in RTL

  1. Switch interface language to an RTL language (e.g., Arabic or Hebrew).
  2. Reload the article page and trigger the onboarding dialog.
  3. AC3: The popover arrow appears on the left side of the dialog (placement = "bottom-start").
  4. AC4: The dialog aligns properly with the bookmark icon and maintains correct spacing.
screenshot 333.png (1×2 px, 641 KB)
screenshot 334.png (1×2 px, 632 KB)
screenshot 335.png (1×2 px, 497 KB)
HFan-WMF claimed this task.
Restricted Application added a subscriber: alaa. · View Herald TranscriptNov 4 2025, 6:06 PM