Page MenuHomePhabricator

Add "help" link to Special:BlankPage
Open, Stalled, Needs TriagePublic

Description

Special:BlankPage is used by a number of user scripts to create custom interfaces. When a user that doesn't have the relevant script installed, the link makes no sense. Adding a "help" link targeting https://www.mediawiki.org/wiki/Manual:Special_pages#Custom_special_pages would be helpful for such users.

Adding this help link will also allow script developers to change the target to their own help pages, rather than needing to add their own help link functionality. A snippet as simple as $('#mw-indicator-mw-helplink > a')[0].href = '/wiki/Foo'; would be enough to retarget the link.

I'll leave this open for a couple days to see if there are any objections to adding the link.

Event Timeline

Restricted Application added a subscriber: Aklapper. · View Herald TranscriptJul 10 2019, 7:38 PM

Change 522598 had a related patch set uploaded (by DannyS712; owner: DannyS712):
[mediawiki/core@master] Add help link to Special:BlankPage

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

Huji added a subscriber: Huji.Jul 13 2019, 4:38 PM

https://www.mediawiki.org/wiki/Manual:Special_pages#Custom_special_pages does not provide the relevant information (for one thing, it never even mentions Special:BlankPage so for a non-technical user that help page is completely useless).

I am tempted to outright decline this task. It is up to the wikis with those user scripts to also create a pertinent help page and/or a script that would show a help link.

I've added a note about Special:BlankPage

Huji added a comment.Jul 13 2019, 8:12 PM

I still think someone else with more experience should give this some consideration; I continue to think that the help message should be wiki-specific, and therefore it should not be handled through the code base.

I still think someone else with more experience should give this some consideration; I continue to think that the help message should be wiki-specific, and therefore it should not be handled through the code base.

Per SpecialPage.php, the addHelpLink function's link can be overridden by wikis: Link target can be overridden by a local message containing a wikilink: the message key is: lowercase special page name + '-helppage'. I think its better to have a link specified in the code base that can be overridden rather than having no link at all.

DannyS712 changed the task status from Open to Stalled.Aug 2 2019, 4:47 PM

Awaiting decision on if there should be a help link