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 _______________________________________________ Wikitech-l mailing list [email protected] https://lists.wikimedia.org/mailman/listinfo/wikitech-l
