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

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

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

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

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

        > 読みやすいコードが書けないやつに、ドキュメントを書くなんてそもそも無理。

        ものすごく同意できます。
        ドキュメントが書けないので不要論を展開する輩が多い。
        彼らはドキュメントに記述できる設計思想がないままコーディングしているのでしょうね。
        だからコーディング前には書けないし、コーディング終了後も明記できる設計がない。

        #突貫(特攻)作業中に限り、脳内ドキュメントを許可する。(大本営特別指令)

        親コメント

一つのことを行い、またそれをうまくやるプログラムを書け -- Malcolm Douglas McIlroy

処理中...