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_thre..., https://bugzilla.wikimedia.org/show_bug.cgi?id=40143, https://www.mediawiki.org/wiki/Requests_for_comment/Documentation_overhaul#I... .
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