Page MenuHomePhabricator

Document new addHelpLink() in 1.25
Closed, ResolvedPublic

Description

Gerrit 157497 added addHelpLink() feature. It could be documented better.

  • It's not mentioned in RELEASE-NOTES-1.25 (the underlying indicator facility is).
  • Its doxgen help doesn't document the parameters or mention the hardcoded //www.mediawiki.org/wiki/Special:MyLanguage/ URL path.
  • The BoilerPlate extension's SpecialHelloWorld.php should show this working.
  • It's not mentioned on mediawiki.org pages such as writing an extension, Category:Extension help, Project:PD Help, etc. (I'll work on this bit.)

Event Timeline

Spage raised the priority of this task from to Needs Triage.
Spage updated the task description. (Show Details)
Spage subscribed.
Spage updated the task description. (Show Details)
Spage set Security to None.
Nemo_bis added a project: Patch-For-Review.

I was already working on documentation as part of the parent task: https://gerrit.wikimedia.org/r/208378

Nemo_bis subscribed.

Ic849dde00be7379c1909a8486cf20f48c5aea5cf / rMW36801c9e907b does all this, someone else can continue.

I've never touched the extension example but I added https://www.mediawiki.org/w/index.php?title=Manual%3ASpecial_pages&type=revision&diff=1645623&oldid=1557945

greg triaged this task as Medium priority.May 13 2015, 7:14 PM

Change 212906 had a related patch set uploaded (by Microchip08):
add an addHelpLink() example

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

Change 212906 merged by jenkins-bot:
add an addHelpLink() example

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

MC8 updated the task description. (Show Details)

The Doxygen information seems sufficient as it is. I've added the documentation to a couple of places on MediaWiki.org; not sure there's anywhere else appropriate.

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

Docs look good to me (code docs + example extension usage), plus initial docs on-wiki.

MW.org can always be cleaned up later if need be.