Provide action=help entry point for all modules of an extension/group
Open, LowPublic

Description

The new way to display help will greatly simplify and prettify documentation such as https://www.mediawiki.org/wiki/Help:Extension:Translate/API#Web-API

I would be even happier if https://translatewiki.net/w/api.php?action=help&modules=query+messagecollection%7Cquery+messagegroups%7Cquery+messagegroupstats%7Cquery+messagetranslations%7Ctranslationreview%7Cttmserver%7Cgroupreview and similar could be replaced by some concise alternative.

We do have $ ack "ingroup API TranslateAPI"
ApiTranslateUser.php
14: * @ingroup API TranslateAPI
etc., but I doubt that helps anything. It would be nice if the groups could be exposed in more ways.


Version: unspecified
Severity: enhancement

Details

Reference
bz72103
bzimport raised the priority of this task from to Low.
bzimport set Reference to bz72103.
bzimport added a subscriber: Unknown Object (MLST).
Reedy added a comment.Oct 16 2014, 1:22 PM

Yeah, we'd need some functionality in the API to set a group for a module.

The @ingroup docs isn't available to the code in anyway

Shouldn't be too difficult though I don't think....

Not too difficult, but it's also likely to be somewhat poorly performing since it would require recursing through all modules and filtering by this group field.

We've long cached the old API help page for this sort of reason, and the new help page is cached too in the commonly-hit case with recursivesubmodules. We'll have to consider whether the hits to this would be uncommon enough that the performance hit wouldn't be prohibitive, or often enough that it would be worth the potentially-large number of cache entries.