アカウント名:
パスワード:
できあがったものの簡潔な説明は、確かにここで指摘されたように有用だと思う。けど、設計書にその役割を求めると、理想はともかくとして大概「格言」に引っ掛かることになるよね。
よく出来たドキュメントのあるプログラムは、プログラム自身がよく出来ているので、そのドキュメントは参照されないという・・・。不出来なプログラムには、ドキュメント自体が無い場合が多い。
より多くのコメントがこの議論にあるかもしれませんが、JavaScriptが有効ではない環境を使用している場合、クラシックなコメントシステム(D1)に設定を変更する必要があります。
普通のやつらの下を行け -- バッドノウハウ専門家
前か後か (スコア:1)
できあがったものの簡潔な説明は、確かにここで指摘されたように有用だと思う。
けど、設計書にその役割を求めると、理想はともかくとして大概「格言」に引っ掛かることになるよね。
Re:前か後か (スコア:0)
よく出来たドキュメントのあるプログラムは、プログラム自身が
よく出来ているので、そのドキュメントは参照されないという・・・。
不出来なプログラムには、ドキュメント自体が無い場合が多い。