On Sat, Jun 8, 2013 at 8:26 AM, Brad Jorsch bjorsch@wikimedia.org wrote:
On Sat, Jun 8, 2013 at 11:07 AM, Brian Wolff bawolff@gmail.com wrote:
Both Manual:Hooks/foo and all the $wgFoo pages can definitely benefit from some automation.
I know the reason I usually don't update the Manual pages is because by the time the change gets reviewed and merged, I don't remember anymore that the change actually requires Manual page updates. I have the same problem with remembering to close bugs; the automated comments posted to the bug on merge now often remind me, at least for bugs I'm on the CC list for.
A bit late, but I wrote a script[1] to do this today, since I didn't want to manually create a page for the hook I added to core today[2].
It's not totally perfect, [3] doesn't look that nice, and it's not smart enough to figure out things like the type of an object based on reading the text.
If someone were to write a bot that would comment on the changeset after it was merged linking to hook and $wgFoo manual pages that probably need updating, that would serve as a useful reminder.
If people like this script, we could have a bot automatically create a stub page on mw.o when the change is merged, and then a human can fix it up.
-- Legoktm
[1] https://github.com/legoktm/mwhooks/blob/master/create_onwiki.py [2] https://www.mediawiki.org/wiki/Manual:Hooks/GetLogTypesOnUser [3] https://www.mediawiki.org/wiki/Manual:Hooks/WikiPageDeletionUpdates