Page MenuHomePhabricator

Improve onboarding dialog timing
Closed, ResolvedPublic2 Estimated Story Points

Description

Background

Currently, after a user creates an account, we show a “Get started” popover designed primarily for editors. With the introduction of Reading List (RL), we will also show a Reading List onboarding popover to new accounts during the RL beta phase.

At the moment, both onboarding dialogs can appear at the same time (as shown below), leading to a confusing experience.

Screenshot 2026-03-30 at 3.07.51 PM.png (1,882×1,514 px, 299 KB)

We want to ensure these onboarding experiences are properly sequenced and timed. The editor-focused “Get started” popover should take priority, followed by the Reading List onboarding.

User Story

As a new account holder, I want onboarding dialogs to appear in a clear and non-overlapping sequence,
so that I can understand each feature without confusion.

Requirements

The following requirements are for both Desktop and Mobile.

Sequencing of pop overs

  • Do not show the Reading List onboarding popover at the same time as the “Get started” editor popover.
  • Trigger the Reading List onboarding on a subsequent page the user navigates to after dismissing the “Get started” dialog.

Exclusions

  • Do not show the Reading List onboarding on the homepage.

Event Timeline

aude triaged this task as High priority.Apr 1 2026, 5:54 PM
aude moved this task from Ready for sprint to Needs refinement on the Reader Experience Team board.
aude set the point value for this task to 2.Apr 6 2026, 1:15 PM
aude moved this task from Needs refinement to Ready for sprint on the Reader Experience Team board.

For completion, in OOUI there was a "WindowManager" were different windows could be queued up.

Change #1269498 had a related patch set uploaded (by Stoyofuku-wmf; author: Stoyofuku-wmf):

[mediawiki/extensions/ReadingLists@master] Make onboarding dialog a little less eager beaver 🦫

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

Change #1269498 merged by jenkins-bot:

[mediawiki/extensions/ReadingLists@master] Make onboarding dialog a little less eager beaver 🦫

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

Change #1269552 had a related patch set uploaded (by Aude; author: Stoyofuku-wmf):

[mediawiki/extensions/ReadingLists@wmf/1.46.0-wmf.23] Make onboarding dialog a little less eager beaver 🦫

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

Change #1269552 merged by jenkins-bot:

[mediawiki/extensions/ReadingLists@wmf/1.46.0-wmf.23] Make onboarding dialog a little less eager beaver 🦫

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

Mentioned in SAL (#wikimedia-operations) [2026-04-09T20:18:51Z] <aude@deploy1003> Started scap sync-world: Backport for [[gerrit:1269552|Make onboarding dialog a little less eager beaver 🦫 (T421942)]]

Mentioned in SAL (#wikimedia-operations) [2026-04-09T20:20:32Z] <aude@deploy1003> aude: Backport for [[gerrit:1269552|Make onboarding dialog a little less eager beaver 🦫 (T421942)]] synced to the testservers (see https://wikitech.wikimedia.org/wiki/Mwdebug). Changes can now be verified there.

Mentioned in SAL (#wikimedia-operations) [2026-04-09T20:28:56Z] <aude@deploy1003> Finished scap sync-world: Backport for [[gerrit:1269552|Make onboarding dialog a little less eager beaver 🦫 (T421942)]] (duration: 10m 05s)

Etonkovidova subscribed.

Tested on beta cluster and in production - the intro tour appears after dismissing "Get started" (Homepage intro tour)

Testing notes

  • requires clearing Browsing data before creating a test account
HFan-WMF claimed this task.