Last modified: 2014-03-14 11:51:40 UTC
Right now we only generate a documentation for PHP code. This can be found here: http://wikidata-docs.wikimedia.de/ It would be nice to have the same for JavaScript code if this is possible somehow.
see: http://www.stack.nl/~dimitri/doxygen/helpers.html
Decided on this method: http://xiewenjie.com/doxygen-js/use-doxygen-to-document-javascript
I see no reason to mark this RESOLVED LATER. If it's not going to be done now, lower the priority.
This is the Wikidata bug, the WMF one is over here: https://bugzilla.wikimedia.org/show_bug.cgi?id=40143 For Wikidata we set up a script that converts .js to .cpp files [1]. We had to adjust parameter names to match the WM coding conventions [2]. But the JS parser fails to parse our prototype definitions, so classes and their hierarchy are not recognized. We will come back to this later. [1] http://xiewenjie.com/doxygen-js/use-doxygen-to-document-javascript [2] http://www.mediawiki.org/wiki/Manual:Coding_conventions/JavaScript#Documentation_comments
[Removing RESOLVED LATER as discussed in http://lists.wikimedia.org/pipermail/wikitech-l/2012-November/064240.html . Reopening and setting priority to "Lowest" as discussed on IRC. For future reference, please use either RESOLVED WONTFIX (for issues that will not be fixed), or simply set lowest priority. Thanks a lot!]