Jump to content

Topic on Talk:MediaWiki Documentation Day 2017

Possible request candidate

7
Mainframe98 (talkcontribs)

I have a possible request for this Documentation day:

Updating Manual:Hooks and create the missing hooks pages listed on Manual talk:Hooks. It's not a difficult task, since the hooks themselves are listed in hooks.txt in the MediaWiki source code. It's basically copy pasting with the occasional typo/format fixing. The only difficulty here would be figuring out it which version the hooks was added, since that's not clear from hooks.txt.

Kaldari (talkcontribs)

Thanks. I've added it to the page. (For anyone else reading this, feel free to add requests directly to the page rather than posting them here.)

Tgr (WMF) (talkcontribs)
Mainframe98 (talkcontribs)

It'd be great if it were automated, but that still leaves Manual:Hooks, and since we do not know when the automation will be ready, the hook pages will remain undocumented for that time. I'm not sure if that's good...

Tgr (WMF) (talkcontribs)

I'd replace Manual:Hooks with some kind of search tool or gadget, it's already pretty unwieldy. As for the automation, it's one of the top entries of this year's developer wishlist. If you are going to the hackathon, let's talk about it :)

Mainframe98 (talkcontribs)

Any kind of search tool that doesn't have to be updated manually would be great anyway. I wish I could attend the hackathon, but that's unfortunately not possible now. Maybe next year?

Tgr (WMF) (talkcontribs)

Roughly:

  • fetch the list of pages using Template:MediaWikiHook from the API
  • parse the wikitext (or maybe parsoid HTML?), fetch template parameters, store them in a DB
  • build an index from the description fields
  • put a simple list/filter UI (something like Hay's directory in front
Reply to "Possible request candidate"