Page MenuHomePhabricator

[Reading List] Behaviour of Watchlist, ReadingList menu items in Vector 2022
Closed, ResolvedPublic5 Estimated Story Points

Assigned To
Authored By
Sneha
Jul 31 2025, 9:41 PM
Referenced Files
F66056025: screenshot 175.png
Sep 18 2025, 5:37 PM
F66056019: screenshot 174.png
Sep 18 2025, 5:37 PM
F66056016: screenshot 173.png
Sep 18 2025, 5:37 PM
F66056012: screenshot 172.png
Sep 18 2025, 5:37 PM
F66056007: screenshot 171.png
Sep 18 2025, 5:37 PM
F66056001: screenshot 170.png
Sep 18 2025, 5:37 PM
F66056000: screenshot 168.png
Sep 18 2025, 5:37 PM
F66055999: screenshot 169.png
Sep 18 2025, 5:37 PM

Description

NOTE: This does not reflect final state. For now we are scoping to users not using watchlist. Providing entry point for both watching and bookmarking will be covered in a latter iteration of project.

Background

As part of the reading list experiment we want to provide a way for users to access their saved articles on web.

User story

  • As a reader, I want to easily access all my saved articles

Design

Screenshot 2025-08-25 at 4.17.34 PM.png (3,004×730 px, 404 KB)

Lower resolution:

Screenshot 2025-08-25 at 4.17.58 PM.png (1,758×788 px, 264 KB)

Requirements

NOTE: The sticky header is out of scope for this ticket. NOTE: Adding icon for menus in tools (watch action) is out of scope for this ticket.

When the reading list feature (currently via beta feature) is enabled:

  • The “Saved” reading list icon appears in the overflow user menu in the header on Vector 2022. The "Watchlist" icon is permanently in the user links menu
  • The "Saved" reading list icon at lower resolutions collapses and appears in the user links menu.
  • The bookmark icon appears in the page actions menu and collapses into the tools menu at low resolutions.
  • The "watch" link appears in the tools menu without an icon.

When the reading list feature (currently via beta feature) is disabled:

  • There is no icon for adding articles to bookmarks list.
  • There is no link to the saved list.
  • The watchstar icon appears in the page actions and collapses into the tools menu at low resolutions
  • The watchlist link icon appears in the overflow user menu and collapses into the user menu.

Technical requirements

  • We do not want to display both the reading list and watchlist icons in the user overflow menu as this would require responsive design changes e.g. when the search bar collapses. For now it is acceptable to use CSS to hide the watchlist icon as that will keep the code cleaner.

Design

Final icon to be provided. Adding new icon to Codex is tracked here T400948: icons: Add [Saved] 'bookmarkList' icon to Codex

BDD

Feature: Vector 2022 Reading List and Watchlist menu behavior

  Scenario: Reading List feature enabled
    Given I am logged in and the Reading List feature is enabled
    When I view the header in Vector 2022
    Then the “Saved” list icon appears in the overflow user menu
    And the Watchlist icon is in the user links menu
    And the bookmark icon appears in page actions
    And the Watch link appears in tools menu without an icon
    And at lower resolutions the “Saved” list icon collapses into the user links menu
    And the bookmark collapses into the tools menu

  Scenario: Reading List feature disabled
    Given I am logged in and the Reading List feature is disabled
    When I view the header in Vector 2022
    Then no bookmark icon or “Saved” list link is shown
    And the watchstar icon appears in page actions and collapses into the tools menu at lower resolutions
    And the Watchlist icon appears in the overflow user menu and collapses into the user menu

Test Steps

Test Case 1: Reading List feature enabled

  1. Log in and enable Reading Lists in preferences.
  2. Open an article in Vector 2022 skin.
  3. AC1: “Saved” list icon is visible in the header user menu.
  4. AC2: Watchlist icon is visible in the user links menu.
  5. AC3: Bookmark icon is visible in page actions.
  6. AC4: Watch link is visible in tools menu without an icon.
  7. Resize to a narrow viewport.
  8. AC5: “Saved” list icon collapses into the user links menu.
  9. AC6: Bookmark icon collapses into the tools menu.

Test Case 2: Reading List feature disabled

  1. Log in and disable Reading Lists in preferences.
  2. Open an article in Vector 2022 skin.
  3. AC7: No bookmark icon or “Saved” list link is visible.
  4. AC8: Watchstar icon is visible in page actions and collapses into tools menu at narrow viewport.
  5. AC9: Watchlist icon is visible in the overflow user menu and collapses into the user menu at narrow viewport.
  6. AC10: Watchlist and Reading List icons do not appear simultaneously in the overflow user menu.

QA Results - Beta

QA Results - Prod

Event Timeline

There are a very large number of changes, so older changes are hidden. Show Older Changes
Jdrewniak renamed this task from [Reading List] A way for users to access the saved articles to [Reading List] Add ReadingList icon to user menu + user overflow menu in Vector 2022.Aug 5 2025, 2:16 PM
Jdrewniak triaged this task as High priority.
Jdrewniak updated the task description. (Show Details)
Jdrewniak moved this task from Incoming to Needs refinement on the Reader Experience Team board.
Jdrewniak updated the task description. (Show Details)

Meeting notes: @aude to determine if this has already been implemented.

I just checked this out on beta cluster and I want to note that the current implementation diffs from the designs in the descriptions. The readingList icon is present in the user menu, however, it's not present in the "overflow" menu (i.e. beside the watchlist icon).

current wide widthcurrent narrow width
Screenshot 2025-08-13 at 11.21.36 AM.png (922×488 px, 38 KB)
Screenshot 2025-08-13 at 11.22.05 AM.png (914×804 px, 109 KB)
desired wide widthdesired narrow width
Icon in header.png (938×430 px, 31 KB)
Saved item in menu.png (600×534 px, 176 KB)

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

[mediawiki/skins/Vector@master] WIP - Allow adding items (e.g. readinglists) to user overflow menu

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

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

[mediawiki/extensions/ReadingLists@master] WIP - Add readinglists to user overflow menu

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

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

[mediawiki/skins/Vector@master] WIP - Allow adding reading lists to views toolbar and user overflow menu

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

Change #1178977 abandoned by Aude:

[mediawiki/skins/Vector@master] WIP - Allow adding items (e.g. readinglists) to user overflow menu

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

Change #1178978 abandoned by Aude:

[mediawiki/extensions/ReadingLists@master] WIP - Add readinglists to user overflow menu

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

aude removed aude as the assignee of this task.Aug 20 2025, 2:34 PM
aude subscribed.

Change #1180624 had a related patch set uploaded (by Jdlrobson; author: Jdlrobson):

[mediawiki/extensions/ReadingLists@master] Update to reading list link presentation

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

@Sneha could we descope the divider in the menu as that would complicate this task considerably?

Jdlrobson-WMF renamed this task from [Reading List] Add ReadingList icon to user menu + user overflow menu in Vector 2022 to [Reading List] Behaviour of Watchlist, ReadingList menu items in Vector 2022.Aug 25 2025, 5:46 PM
Jdlrobson-WMF updated the task description. (Show Details)
Jdlrobson-WMF updated the task description. (Show Details)
Jdlrobson-WMF changed the task status from Stalled to Open.Aug 25 2025, 5:52 PM
Jdlrobson-WMF updated the task description. (Show Details)

@Jdlrobson I have updated the design without divider lines and kept the same order as is. Also I am not able to find the ticket with sticky header changes. Can you point me to that?

Jdlrobson-WMF set the point value for this task to 5.Aug 26 2025, 4:03 PM

From Slack (2 3s and 2 5s)

Change #1180625 had a related patch set uploaded (by Jdlrobson; author: Jdlrobson):

[mediawiki/skins/Vector@master] Treat reading list as a collapsible user link

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

Change #1180624 had a related patch set uploaded (by Jdlrobson; author: Jdlrobson):

[mediawiki/extensions/ReadingLists@master] Update to reading list link presentation

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

This is blocked on the OOUI release but would love to get some input on the approach before writing some tests.

Change #1180625 merged by jenkins-bot:

[mediawiki/skins/Vector@master] Treat reading list as a collapsible user link

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

Jdlrobson-WMF changed the task status from Open to Stalled.Sep 2 2025, 5:26 PM

(Blocked on OOUI release - I will link ticket when it's tracked down)

Jdlrobson-WMF lowered the priority of this task from High to Medium.Sep 3 2025, 10:19 PM

Change #1180624 merged by jenkins-bot:

[mediawiki/extensions/ReadingLists@master] Update to reading list link presentation

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

Test Result - Beta

Status: ✅ PASS
Environment: beta
OS: macOS Sequoia 15.5
Browser: Chrome Canary (latest as of test date)
Device: MS
Emulated Device: NA

Test Case 1: Reading List feature enabled

  1. Log in and enable Reading Lists in preferences.
  2. Open an article in Vector 2022 skin.
  3. AC1: “Saved” list icon is visible in the header user menu.
  4. AC2: Watchlist icon is visible in the user links menu.
  5. AC3: Bookmark icon is visible in page actions.
  6. AC4: Watch link is visible in tools menu without an icon.

screenshot 126.png (1,608×740 px, 438 KB)

  1. Resize to a narrow viewport.
  2. AC5: “Saved” list icon collapses into the user links menu.

screenshot 127.png (624×684 px, 194 KB)

  1. AC6: Bookmark icon collapses into the tools menu.

The requirement indicates that an icon will collapse into the tools menu, but the note above indicates that is out of scope, and there are no icons that I can see in the tools menu, so I am passing, but I think the requirement should be clarified.

screenshot 128.png (622×553 px, 156 KB)

Test Case 2: Reading List feature disabled

  1. Log in and disable Reading Lists in preferences.
  2. Open an article in Vector 2022 skin.
  3. AC7: No bookmark icon or “Saved” list link is visible.

screenshot 129.png (1,896×861 px, 482 KB)

  1. AC8: Watchstar icon is visible in page actions and collapses into tools menu at narrow viewport.

screenshot 20.mov.gif (660×944 px, 1 MB)

  1. AC9: Watchlist icon is visible in the overflow user menu and collapses into the user menu at narrow viewport.

screenshot 21.mov.gif (660×944 px, 887 KB)

  1. AC10: Watchlist and Reading List icons do not appear simultaneously in the overflow user menu.

screenshot 132.png (271×393 px, 49 KB)

Edtadros updated the task description. (Show Details)
Edtadros subscribed.

I would like to point out that there are two things that we need to fix below closing this so that it matches the requirements.

  1. The "Saved" link in the user menu should be above the Watchlist link as shown in the mock
  2. When the "Save" action is in the tools menu it should use the copy "Save" / "Unsave" instead of the current "Add bookmark".

The "Saved" link in the user menu should be above the Watchlist link as shown in the mock

Hey @Sneha the "saved" link is above the "watchlist"? Do you mean "directly:" above?

Screenshot 2025-09-09 at 4.13.59 PM.png (487×593 px, 83 KB)

Screenshot 2025-09-09 at 4.14.38 PM.png (315×416 px, 19 KB)

if you mean directly above, we talked about this in our 1 on 1 and my understanding was that the ordering was not a hard requirement. Did I misunderstand?

If it is, please create a new ticket to do that. It's more challenging than one would expect :(

When the "Save" action is in the tools menu it should use the copy "Save" / "Unsave" instead of the current "Add bookmark".

Let's create a follow up ticket for this. Good news is that this should be straightforward.

@Jdlrobson I will create a ticket for copy change and put it in ready for sprint. As for the order of things in the menu I thought we can't do the groupings that I had suggested but were able to insert "Save" above "Watchlist". I can create a new ticket but we can leave it for future and don't need to include now.

I will leave the copy change ticket in needs refinement column until someone adds an estimate. I think we should definitely get this in as the word "bookmark" can potentially be confused with browser bookmark.

Closing this ticket for now, thank you for creating the new follow up tickets, Sneha! I'll try to get the copy change into this sprint.

Test Result - Prod

Status: ✅ PASS
Environment: testwiki
OS: macOS Sequoia 15.6.1
Browser: Chrome Canary (latest as of test date)
Device: MS
Emulated Device: NA

Test Case 1: Reading List feature enabled

  1. Log in and enable Reading Lists in preferences.
  2. Open an article in Vector 2022 skin.
  3. AC1: “Saved” list icon is visible in the header user menu.
  4. AC2: Watchlist icon is visible in the user links menu.
  5. AC3: Bookmark icon is visible in page actions.
  6. AC4: Watch link is visible in tools menu without an icon.

screenshot 169.png (1,763×438 px, 126 KB)

screenshot 168.png (1,675×506 px, 164 KB)

screenshot 170.png (1,756×611 px, 226 KB)

  1. Resize to a narrow viewport.
  2. AC5: “Saved” list icon collapses into the user links menu.

screenshot 171.png (577×637 px, 136 KB)

  1. AC6: Bookmark icon collapses into the tools menu.

The requirement indicates that an icon will collapse into the tools menu, but the note above indicates that is out of scope, and there are no icons that I can see in the tools menu, so I am passing, but I think the requirement should be clarified.

screenshot 172.png (582×782 px, 159 KB)

Test Case 2: Reading List feature disabled

  1. Log in and disable Reading Lists in preferences.
  2. Open an article in Vector 2022 skin.
  3. AC7: No bookmark icon or “Saved” list link is visible.

screenshot 173.png (1,688×708 px, 271 KB)

  1. AC8: Watchstar icon is visible in page actions and collapses into tools menu at narrow viewport.

screenshot 174.png (511×705 px, 127 KB)

  1. AC9: Watchlist icon is visible in the overflow user menu and collapses into the user menu at narrow viewport.

screenshot 175.png (511×620 px, 118 KB)

  1. AC10: Watchlist and Reading List icons do not appear simultaneously in the overflow user menu.

See Above