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

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

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

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

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

普通のやつらの下を行け -- バッドノウハウ専門家

処理中...