タグ

Javaとコメントに関するkiyo_hikoのブックマーク (1)

  • Javadocを書かない - しげるメモ

    前回はJavadocを書く - しげるメモというタイトルで話を進めましたが、今回は逆にJavadocを減らすプラクティスについてメモがてら。 私は別にJavadocを書くのが好きなわけではなく、単純に書いたほうがめんどくさくないと思うのでそうしてます。ただ、Javadocを書くのもかなりめんどくさいとは自分自身で感じているので、そのめんどくささをできるだけ減らす道を現在も模索中です。 やり方としては単純で、次のうちどちらかです。 Javadocをそもそも書かない Javadocに書くことを減らす かなりの部分がEffective Java (Java Series)に紹介されているプラクティスとかぶりますが、ここではあくまで"めんどくさくないJavadoc"という視点でいきます。 Javadocをそもそも書かない If an API is to be usable, it must be

    Javadocを書かない - しげるメモ
    kiyo_hiko
    kiyo_hiko 2010/10/28
    インターフェースに書くというのは確かに良いと思った。最近Javaはインターフェースが好き。継承嫌い。不変オブジェクト好き。ジェネリックス好き。Haskellもそうだけど、型にうるさいほど説明は「型がやってくれる」。
  • 1