Page MenuHomePhabricator

Update script for generating MW-wiki documentation to include config descriptions
Closed, ResolvedPublic2 Estimated Story Points

Description

We have a script for generating the wikitext that goes on the extension page on the MW-wiki. Since we now use descriptions for config parameters in extension.json, use them when generating the config table.

Event Timeline

Also consider sticking the script in it's own repo (if it's likely re-usable by other actors).

@Sebastian_Berlin-WMSE: Would it make sense to move the current text under the Documentation mw:Extension:Wikispeech#Complete_list_of_configuration_options into the description parameters of the extension.json?

I'll look into adding a flag for specifying schema version and keeping the old logic. If we want others to use this, there are plenty of extension still using manifest version 1.

Added a note to the weekly meeting about how to deal with mediawiki.org's sudden self-updating feature.

Note that we could theoretically also populate the Complete list of configuration options section using a module+template which works of mw:Module:ExtensionJson