エンジニアのためのJavadoc再入門講座 現場で使えるAPI仕様書の作り方

エンジニアのためのJavadoc再入門講座 現場で使えるAPI仕様書の作り方
このシリーズのwordの本は非常に素晴らしかったが、それにはやや劣る。javadocは、junitを使う場合と、そうじゃない場合で大きく記述内容が変わる(と俺は信じている)のでjunitに触れず(単体テストの記述量が仕様記述より丁寧になるようにするべし)にjavadocを解説されるとちょっと不満。
まぁjavadocに絞った本だから、という観点で見ると素晴らしい点が幾つかある、気に入ったのは
 ・ソースの説明を書くのではなく、「使う人からみた仕様」を書く
 ・javadocコマンドの使い方をかなり詳しく解説してあるのでコマンドリファレンスとして重宝する
 ・DbCjavadocを組み合わせる方法論について言及してある
これらは、本書意外では読めない知識で、非常にためになった。