On Tue, Jun 4, 2013 at 1:40 PM, Brad Jorsch <bjor...@wikimedia.org> wrote: > On Tue, Jun 4, 2013 at 12:00 PM, Antoine Musso <hashar+...@free.fr> wrote: >> >> Since we introduced hooks in MediaWiki, the documentation has been >> maintained in a flat file /docs/hooks.txt . Over the week-end I have >> converted the content of that file to let Doxygen recognize it. >> >> The patchset is: >> https://gerrit.wikimedia.org/r/#/c/66128/ > > The result is pretty. But personally I'll probably continue to just > look in hooks.txt if I need the info in there, and the markup in the > (now-misnamed) file is rather ugly. Not that the existing file isn't > also ugly, just less so. >
I'm with Brad. Considering we document this in the tree and on mw.org, I'm not entirely sure what the benefit of having it done via Doxygen is. -Chad _______________________________________________ Wikitech-l mailing list Wikitech-l@lists.wikimedia.org https://lists.wikimedia.org/mailman/listinfo/wikitech-l