On 11/13/2013 01:22 PM, Quim Gil wrote:
Wikimedia's Engineering Community team is
responsible for developing
clear documentation for MediaWiki. All of our documentation is written
collaboratively in wiki pages, involving all kinds of profiles, from WMF
professional developers to anonymous users. There are some areas of our
documentation that lack content or are outdated, while others have grown
organically and they need pruning and polishing. It is complex to
recruit volunteers for this type of work.
Some of it is also in repositories. Doxygen and JSDuck are used for API
documentation. docs/hooks.txt documents hooks, though hooks.txt has an
awkward and inefficient relationship with the on-wiki hook documentation
(this was discussed a earlier, and legoktm has an in-progress script).
API documentation may not be within the scope of the position, but it
may be worth mentioning to avoid "all of our documentation" being
misleading.
Matt Flaschen