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

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

_______________________________________________
Wikitech-l mailing list
[email protected]
https://lists.wikimedia.org/mailman/listinfo/wikitech-l

Reply via email to