アカウント名:
パスワード:
きちんとドキュメントをまとめることができるプログラマのコードには、そもそもドキュメントは必要ない、ような気がする。
#経験則では、ないです。
> 読みやすいコードが書けないやつに、ドキュメントを書くなんてそもそも無理。
ものすごく同意できます。ドキュメントが書けないので不要論を展開する輩が多い。彼らはドキュメントに記述できる設計思想がないままコーディングしているのでしょうね。だからコーディング前には書けないし、コーディング終了後も明記できる設計がない。
#突貫(特攻)作業中に限り、脳内ドキュメントを許可する。(大本営特別指令)
より多くのコメントがこの議論にあるかもしれませんが、JavaScriptが有効ではない環境を使用している場合、クラシックなコメントシステム(D1)に設定を変更する必要があります。
ソースを見ろ -- ある4桁UID
憶測でコメントしますが (スコア:0)
きちんとドキュメントをまとめることができるプログラマのコードには、
そもそもドキュメントは必要ない、ような気がする。
#経験則では、ないです。
Re: (スコア:1)
・外部仕様やデザインポリシーはメモ程度で良いのでドキュメント化しとくべき、後になると自分でも何でこんなことをやったのか目的が理解できなくなることがある。
・プログラムの内部仕様をドキュメント化するのは時間の無駄、そんなものを書く時間があるのならば綺麗な読みやすいコードを書くのに時間をかけた方が何倍もまし。
・読みやすいコードが書けないやつに、ドキュメントを書くなんてそもそも無理。
Re:憶測でコメントしますが (スコア:0)
> 読みやすいコードが書けないやつに、ドキュメントを書くなんてそもそも無理。
ものすごく同意できます。
ドキュメントが書けないので不要論を展開する輩が多い。
彼らはドキュメントに記述できる設計思想がないままコーディングしているのでしょうね。
だからコーディング前には書けないし、コーディング終了後も明記できる設計がない。
#突貫(特攻)作業中に限り、脳内ドキュメントを許可する。(大本営特別指令)