アカウント名:
パスワード:
きちんとドキュメントをまとめることができるプログラマのコードには、そもそもドキュメントは必要ない、ような気がする。
#経験則では、ないです。
これは間違い。
ドキュメントとコードが2つの異なる事を言っている場合は、最低限でもどちらかが間違っている(下手をすると両方間違っている)。
ドキュメントとコードが同じ事を言っている場合、両方をチェックする事でバグの存在を発見できる確率は飛躍的に高まる(人間は、同じ数学問題でも提示のされ方によって解きやすい場合と解きにくい場合がある)。
このように、ドキュメントは「内容確認」のために使うものなので、省いてよいものではないし、機械生成するべきものでもない。# 機械生成した場合は、プログラマ自身がそれを声に出して朗読するべきである。# 大抵、バグが見つかる。
より多くのコメントがこの議論にあるかもしれませんが、JavaScriptが有効ではない環境を使用している場合、クラシックなコメントシステム(D1)に設定を変更する必要があります。
計算機科学者とは、壊れていないものを修理する人々のことである
憶測でコメントしますが (スコア:0)
きちんとドキュメントをまとめることができるプログラマのコードには、
そもそもドキュメントは必要ない、ような気がする。
#経験則では、ないです。
ドキュメントは、「プログラムが読めない人のためのもの」ではない (スコア:3, 興味深い)
これは間違い。
ドキュメントとコードが2つの異なる事を言っている場合は、最低限でもどちらかが間違っている(下手をすると両方間違っている)。
ドキュメントとコードが同じ事を言っている場合、両方をチェックする事でバグの存在を発見できる確率は飛躍的に高まる(人間は、同じ数学問題でも提示のされ方によって解きやすい場合と解きにくい場合がある)。
このように、ドキュメントは「内容確認」のために使うものなので、省いてよいものではないし、機械生成するべきものでもない。
# 機械生成した場合は、プログラマ自身がそれを声に出して朗読するべきである。
# 大抵、バグが見つかる。
fjの教祖様