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

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

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

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

    • by Anonymous Coward
      経験則から言うと
      ・外部仕様やデザインポリシーはメモ程度で良いのでドキュメント化しとくべき、後になると自分でも何でこんなことをやったのか目的が理解できなくなることがある。
      ・プログラムの内部仕様をドキュメント化するのは時間の無駄、そんなものを書く時間があるのならば綺麗な読みやすいコードを書くのに時間をかけた方が何倍もまし。
      ・読みやすいコードが書けないやつに、ドキュメントを書くなんてそもそも無理。
      • by Anonymous Coward

        >後になると自分でも何でこんなことをやったのか目的が理解できなくなることがある

        その補足のために前のコードをコメントアウトして残したりしてたけど、上司から削除しろと言われたりしたっけ。

        • by Anonymous Coward on 2012年01月17日 23時06分 (#2082360)
          そういうのはバージョン管理システムのコミットログに書くべき事であって、コード上に残す物じゃ無いよ。
          親コメント
          • by Anonymous Coward

            内容によるんじゃない?
            「変数がvolatileなのは・・・からアクセスされる為」
            とかコミットログに書いてあったら大変。

最初のバージョンは常に打ち捨てられる。

処理中...