パスワードを忘れた? アカウント作成
この議論は賞味期限が切れたので、アーカイブ化されています。 新たにコメントを付けることはできません。

プログラマーにドキュメントを書かせるには?」記事へのコメント

  • きちんとドキュメントをまとめることができるプログラマのコードには、
    そもそもドキュメントは必要ない、ような気がする。

    #経験則では、ないです。

    • これは間違い。

      ドキュメントとコードが2つの異なる事を言っている場合は、最低限でもどちらかが間違っている(下手をすると両方間違っている)。

      ドキュメントとコードが同じ事を言っている場合、両方をチェックする事でバグの存在を発見できる確率は飛躍的に高まる(人間は、同じ数学問題でも提示のされ方によって解きやすい場合と解きにくい場合がある)。

      このように、ドキュメントは「内容確認」のために使うものなので、省いてよいものではないし、機械生成するべきものでもない。
      # 機械生成した場合は、プログラマ自身がそれを声に出して朗読するべきである。
      # 大抵、バグが見つかる。

      --
      fjの教祖様
      親コメント

未知のハックに一心不乱に取り組んだ結果、私は自然の法則を変えてしまった -- あるハッカー

処理中...