User Story
As a user I want to be made aware of how to assign labels to watchlist items.
Acceptance criteria
- When I visit the watchlist after labels are enabled I see a set of popups to tell me about assigning labels to watchlist items.
- The popups should appear for skins (such as Vector-2022) that support the associated-pages menu as well as skins that don't.
Details for QA
- Should appear only until the user dismisses it with the 'Got it' button, and should not appear again afterwards.
- The dismissal is saved as a hidden user preference, so will apply to a user regardless of what device they're using.
- The only way to un-dismiss the onboarding after clicking 'Got it' is with the "reset settings" link in Special:Preferences (or deleting the row in the user_properties DB table where up_property = watchlistlabelonboarding).
Designs
Full designs here https://www.figma.com/design/CdyroPkkcT7GJA9bwno0Rq/WE1.4-Task-priotization?node-id=327-15767&p=f&t=it3KLwgfVRsWHUqn-0
The SVGs can be extracted from the Figma project.
Vector-2022
- 1 of 3: Create labels Go to 'Manage labels' to create, rename and delete custom labels.
- 2 of 3: Assign labels Go to 'Edit watchlist' to assign labels to watched pages.
- 3 of 3: Filter by labels Go to 'Labels' to filter the edits.
Legacy
- 1 of 2: Create and assign labels In 'Manage labels' create custom labels and assign them in 'Edit watchlist'.
- 2 of 2: Filter by labels Go to 'Labels' to filter the edits.
Derived Requirement
Ensure that users are informed about how to assign and use watchlist labels by displaying a one-time onboarding popup sequence the first time they visit their watchlist after watchlist labels are enabled, such that the onboarding appears across supported and unsupported skins, persists until explicitly dismissed, is stored as a hidden user preference across devices, and does not reappear unless the user resets their preferences.
Test Steps
Test Case 1: Show onboarding popup on first watchlist visit after labels are enabled
- Log in as a named user who has not previously dismissed the watchlist label onboarding.
- Ensure watchlist labels are enabled for the wiki.
- Navigate to Special:Watchlist.
- Observe the page behavior.
- ✅❓❌⬜ AC1: Confirm that an onboarding popup sequence explaining watchlist labels is displayed on the first visit to the watchlist.
Test Case 2: Display onboarding on skins with and without associated-pages menu support
- Log in as a named user who has not dismissed the onboarding.
- Navigate to Special:Watchlist using a skin that supports the associated-pages menu (for example, Vector-2022).
- Observe the onboarding popup sequence.
- Switch to a skin that does not support the associated-pages menu.
- Navigate again to Special:Watchlist.
- ✅❓❌⬜ AC2: Confirm that the onboarding popup sequence is shown on both skin types.
Test Case 3: Persist onboarding until dismissed
- While viewing the onboarding popup sequence, navigate away from the watchlist without clicking the 'Got it' button.
- Return to Special:Watchlist.
- Observe the onboarding behavior.
- ✅❓❌⬜ AC3: Confirm that the onboarding popup continues to appear until the user explicitly dismisses it using the 'Got it' button.
Test Case 4: Stop showing onboarding after dismissal
- Navigate to Special:Watchlist with the onboarding popup visible.
- Click the 'Got it' button to dismiss the onboarding.
- Reload the page.
- Navigate away and return to Special:Watchlist.
- ✅❓❌⬜ AC4: Confirm that the onboarding popup does not appear again after being dismissed.
Test Case 5: Persist dismissal across devices and sessions
- Dismiss the onboarding popup as a named user.
- Log out or open a new browser session or device.
- Log back in as the same user.
- Navigate to Special:Watchlist.
- ✅❓❌⬜ AC5: Confirm that the onboarding popup remains dismissed across sessions and devices.
Test Case 6: Reset onboarding via user preferences
- As a user who has dismissed the onboarding, navigate to Special:Preferences.
- Select the option to reset settings.
- Save the preference changes.
- Navigate to Special:Watchlist.
- ✅❓❌⬜ AC6: Confirm that the onboarding popup sequence is shown again after resetting user preferences.
QA Results -Beta
| AC | Status | Details |
|---|---|---|
| 1 | ✅ | T408235#11484228 |
| 2 | ✅ | T408235#11484228 |
| 3 | ✅ | T408235#11484228 |
| 4 | ✅ | T408235#11484228 |
| 5 | ✅ | T408235#11484228 |
| 6 | ✅ | T408235#11484228 |
