Hello! Where might I find documentation on the new maintenance runner system? I can't find any examples in the Phabricator task or the linked RFC, and searching for "MaintenanceRunner" or "run.php" yields no results on mediawiki.org. Specifically, I was expecting Manual:run.php to exist with some info on how it works.
If given a good example patch, I'm happy to help write the docs :)
Hello,
run.php is more or less a wrapper so that instead of invoking:
php maintenance/parse.php
One should use:
maintenance/run parse
That will be released in MediaWiki 1.40 and all maintenance scripts will emit a warning to the console when invoked directly.
Here are some references to assist in writing the documentation:
And as an extra, I have implemented a back compat layer in Quibble (which is written in Python): https://gerrit.wikimedia.org/r/c/integration/quibble/+/875981/6/quibble/mediawiki/maintenance.py