JavaScriptのコメントからの自動ドキュメントにHeaderDocを採用

JavaScriptのコメントからの自動ドキュメントにHeaderDocを採用することにしました。

• http://developer.apple.com/opensource/tools/headerdoc.html

JSDocとHeaderDocとを比較したのですが、ある特定の機能において JSDocでは実現できないことが HeaderDocで実現できるという点を見いだしたので、HeaderDocを選択したほうが良いとの判断を得ました。
HeaderDocは Appleがおこなっているオープンソース活動の一環となるプロダクトです。