Hello,
As part of the documentation of mediawiki, I am willing to document the code. I am testing phpdocumentator ( http://www.phpdoc.org/ ).
It works by using comments in the code that looks like:
/** * Method to return an articleID * @private */ function getArticleID () { ... }
You can get an output example at : http://www.twenkill.net/mwdoc/ (site available only when I am online).
Are we willing to flood our code with such comments ? I personally think it will help new developpers to come help us and let older developpers to better understand the whole software.
cheers,