We have all these JavaScript documentation comments, but we're not
actually generating docs. This has been talked about before, e.g.
http://www.gossamer-threads.com/lists/wiki/wikitech/208357?do=post_view_thr…,
https://bugzilla.wikimedia.org/show_bug.cgi?id=40143,
https://www.mediawiki.org/wiki/Requests_for_comment/Documentation_overhaul#…
.
I don't think Doxygen is the best choice, though. JavaScript is really
put forth as a sort-of afterthought.
I suggest JSDoc (
http://usejsdoc.org/), simply because it's a standard
library and has has been put forward in the past, with good rationale.
I know there are other good ones too.
What do you think?
Matt Flaschen