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

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

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

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

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

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

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

        • by Anonymous Coward
          そういうのはバージョン管理システムのコミットログに書くべき事であって、コード上に残す物じゃ無いよ。

長期的な見通しやビジョンはあえて持たないようにしてる -- Linus Torvalds

処理中...