<html><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type">
</head><body bgcolor="#FFFFFF" text="#000000">Gregory Szorc wrote:
<blockquote
cite="mid:CAJTgH0mBVFW4H_r-cZ=_3++xsYRis39DZ=0OXOUZ7f3o1SZ9Aw@mail.gmail.com"
type="cite">
<div>That reminds me of another area for improvement:
automatic documentation generation. I think its wasteful of developers'
time to update inline source/API docs *and* MDN. We should generate API
docs from source code and markup MDN docs with additional comments, like
how MSDN, <a moz-do-not-send="true" href="http://php.net">php.net</a>,
etc do their docs.
Extraction of documentation from source also enables IDEs and editors to
have cool features like autocomplete and pop-ups containing usage docs.
This does poke the hornets nest of how to format docs. But I'd like to
think the end result outweighs the pain to transition to it.</div>
</blockquote>
<br>
Yep. <span>I've noticed a general trend towards <a
href="http://usejsdoc.org/">JSDoc</a> compliant formatting - and all my
new code is documented following the JSDoc spec.<br>
<br>
- Blair<br>
</span></body></html>