Javadoc の書き方 - イトウ アスカ blog
みなさん、Javadoc 書いてますか？ Javadoc は「API ドキュメント」と言われることが多いように、主にライブラリ的なプログラムで書いてこそのものだと思っている方もいるかもしれません。しかしながら、仕様書を Word や Excel（笑）で別途作ると、プログラムと仕様書の同期がとれてないというはめに陥り易くなりますので、Javadoc はどんなときも活用したいというのが私の考え方です。 まず、overview.html を書け Javadoc コメントをいくらか書くような人でも、overview.html を書く人は意外と少ないのではないでしょうか。リファクタリングが何度となく行われるアジャイル開発の現場では、クラスの構成がよくかわりますので、いちいち詳しいコメントを書いていられないということはあるかもしれませんが、overview.html はそれほど何度も手をつけるようなも
プログラムに黄金比を取り入れる - 404 じゃばてないわー Not Found(一部X-RATED)
黄金比って言うのがデザインの世界にあります。1：1.618というやつで、デザイン的に安定するとか言うやつ。世の中のいろんなものが黄金比で作られているとかいないとか。デザインというと、システム構築の世界にもデザインというのがあります。じゃぁこれも黄金比にしたらいいじゃん！って思ったんだけどいったい何の比率を黄金比にするのかなーと思ったので思いつくままに書いてみます。ソースコードとコメントJavaの世界にはJavaDocというのがありますね。この内容を書いたメソッドの行数かける1.618にするというのはどうだろう。単なるアクセサはおいといて、もし１０００行のソースコードを書いたら１６１８行に渡るJavaDocを書くことになりますね。でもまぁ、そんくらい読み手に苦労をかけるソースを書いたんだと体感させる意味ではすばらしいかもしれません。クラス数と潜在バグ数どんなにがんばっても潜在的なバグの数が黄
Contents of /BLIFramework/trunk/Sample/test.ss.src/jp/sf/bli/web/sample/servlet/SampleServletTest.java - BLI - OSDN
Contents of /BLIFramework/trunk/Sample/test.ss.src/jp/sf/bli/web/sample/servlet/SampleServletTest.java Parent Directory | Revision Log Revision 23 - (show annotations) (download) (as text) Sat Feb 24 11:58:01 2007 UTC (15 years, 9 months ago) by bose File MIME type: text/x-java File size: 5640 byte(s)
1
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
処理を実行中です
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
http://code.google.com/intl/ja/apis/gdata/javadoc/index.html?overview-summary.html
mixi 日記アーカイブ
Javadoc Counter - Choco Project
Google Code Archive - Long-term storage for Google Code Project Hosting.
http://www.csg.is.titech.ac.jp/~chiba/javassist/html/index.html
