こんにちわ、DeNA San Francisco の渋川と申します。エンジニアブログには初登場です。 JavaScriptのソースコードからAPIドキュメントを生成するツールには何種類かありますが、日本語の書籍やウェブサイトでも情報が得やすいこともあって、JSDocの系統が幅広く使われています。Google Closure Compilerも、JSDocを拡張したドックコメントをアノテーションとして読み込んで最適化します。 JSDocは長い期間メンテナンスされているオープンソースプロダクトです。初代はPerlで書かれたJSDoc 1です。これはすでにリポジトリも削除されています。現在最も使われているのが JSDoc Toolkit (JSDoc 2) です。弊社の ngCoreのドキュメント でも使用しています。 ただ、これも現在は機能追加を停止していて、後継プロダクトの JSDoc 3
![JSDoc Toolkit→JSDoc 3移行ガイド | BLOG - DeNA Engineering](https://cdn-ak-scissors.b.st-hatena.com/image/square/8759bb75b6b0eeb25adbf66e36e7c888c3b4a928/height=288;version=1;width=512/https%3A%2F%2Fengineering.dena.com%2Fblog%2F2013%2F05%2Fmigration-from-jsdoc2-to-jsdoc3%2Fcover.png)