Page MenuHomePhabricator

Update help link on Special:Watchlist
Closed, ResolvedPublic

Description

The help link on Special:Watchlist goes to https://www.mediawiki.org/wiki/Special:MyLanguage/Help:New_filters_for_edit_review

But if you have enhanced filters (or JavaScript) turned off it goes to https://www.mediawiki.org/wiki/Special:MyLanguage/Help:Watching_pages

The "new filters" are now not far off ten years old, so perhaps should not be considered new any more, so:


Derived Requirement

Ensure that the help link on Special:Watchlist consistently directs users to the general watchlist help page, providing clear and up-to-date guidance regardless of whether enhanced filters or JavaScript are enabled.

Test Steps

Test Case 1: Ensure help link on Special:Watchlist points to the general watchlist help page with enhanced filters enabled

  1. Navigate to Special:Watchlist with JavaScript and enhanced filters enabled.
  2. Locate the help link on the page.
  3. Click the help link.
  4. ✅❓❌⬜ AC1: The help link navigates to 'Help:Watchlist'.

Test Case 2: Ensure help link on Special:Watchlist points to the general watchlist help page with enhanced filters disabled

  1. Disable enhanced filters or JavaScript.
  2. Navigate to Special:Watchlist.
  3. Locate the help link on the page.
  4. Click the help link.
  5. ✅❓❌⬜ AC2: The help link navigates to 'Help:Watchlist' and not to legacy or deprecated help pages.

QA Results -Beta

ACStatusDetails
1T416293#11590200
1T416293#11590200

Event Timeline

Restricted Application added a subscriber: Aklapper. · View Herald Transcript

Hi! I'm a new contributor and I have looked into the documentation pages mentioned in the above task.
My understanding is that the help link on Special:Watchlist currently points to different help pages depending on whether enhanced filters are enabled, and the naming of one of those pages (“New_filters_for_edit_review”) is outdated.
I plan to look into updating the help link to point consistently to Help:Watchlist, and investigate the rename/update of the older help page.
Please let me know if this approach sounds good.

@Complicatedintegral Welcome! Thanks for working on this. You'll likely need to modify resources/src/mediawiki.rcfilters/mw.rcfilters.js. Do you have MediaWiki installed locally for development? See https://www.mediawiki.org/wiki/How_to_become_a_MediaWiki_hacker for some useful info.

@Samwilson Thanks! I have cloned the MediaWiki repository locally.
I am still working on getting a local MediaWiki + Docker setup running, but I will start by inspecting mw.rcfilters.js and preparing a patch based on the code path. I will test it locally once my setup is ready, or flag if I am not able to test efficiently.

@Samwilson I submitted a patch updating the Watchlist help link to point to Help:Watchlist:
https://gerrit.wikimedia.org/r/c/mediawiki/core/+/1236810

This addresses the inconsistency with the help-link as described in the task. I haven't tested it locally because my Docker setup is incomplete.

Regarding the documentation part, the page Help:New_filters_for_edit_review is semi-protected, so I've added a suggestion to remove outdated "New" terminology on its help talk page:
https://www.mediawiki.org/wiki/Help_talk:New_filters_for_edit_review

I'm happy to make further changes if necessary.

Please see https://www.mediawiki.org/wiki/Gerrit/Commit_message_guidelines for how to format the commit message so that the patch is linked to this task.

It'd be best if you could get MediaWiki running locally so that you can test things before pushing changes. Ask at the support desk if you have trouble.

Change #1236810 had a related patch set uploaded (by Complicatedintegral; author: Complicatedintegral):

[mediawiki/core@master] Update Watchlist help link to point to Help:Watchlist

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

Thanks for the pointers! I’ve updated the commit message to follow the Gerrit guidelines and added the Bug: T416293 footer so the patch is properly linked.

I’m still working on getting a full local MediaWiki setup running. I’ll reach out at the support desk if I run into issues setting up a local environment.

Change #1236810 merged by jenkins-bot:

[mediawiki/core@master] Update Watchlist help link to point to Help:Watchlist

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

@Samwilson @Complicatedintegral Shouldn't Mobile have a Help button too? I created a separate task for that in T416657. Confirmed that the help link is on Special:Watchlist, as seen in the videos below for Desktop. I will mark this as Resolved but let me know if you want. Thanks for all your work!

Test Result - Beta

Status: ✅ PASS
Environment: Beta
OS: macOS Tahoe 26.2
Browser: Chrome 143
Device: MBA
Emulated Device: NA

Test Artifact(s):
https://en.wikipedia.beta.wmcloud.org/wiki/Special:Watchlist?hidepreviousrevisions=1&hidecategorization=1&hideWikibase=1&limit=500&days=30&urlversion=2

Test Steps

Test Case 1: Ensure help link on Special:Watchlist points to the general watchlist help page with enhanced filters enabled

  1. Navigate to Special:Watchlist with JavaScript and enhanced filters enabled.
  2. Locate the help link on the page.
  3. Click the help link.
  4. AC1: The help link navigates to 'Help:Watchlist'.
Desktop❓Mobile
2026-02-05_16-32-39.png (1×1 px, 108 KB)

Test Case 2: Ensure help link on Special:Watchlist points to the general watchlist help page with enhanced filters disabled

  1. Disable enhanced filters or JavaScript.
  2. Navigate to Special:Watchlist.
  3. Locate the help link on the page.
  4. Click the help link.
  5. AC2: The help link navigates to 'Help:Watchlist' and not to legacy or deprecated help pages.

GMikesell-WMF updated Other Assignee, removed: GMikesell-WMF.
GMikesell-WMF updated the task description. (Show Details)