アカウント名:
パスワード:
「今回はメンテナンスしやすいようにと思い、ドキュメントは沢山書かせました。」「ただしドキュメントとソースは一致していません。」「ドキュメントも毎日の様に変更されたので、どのバージョンに準拠して書かれたコードなのかは誰にも分かりません。」「ドキュメントに含まれてない仕様も多数存在します。」「また、その分コードを書く時間が減って、コメントとかデバッグの時間が無くなりました。」
プログラムを書いたことがない素人ほど、ドキュメントで問題解決できると勘違いするんだよね。
「しかし、情報が依然まともに伝わって来ないし行かないので、デバッグはなかなか進まなかった。隣の部隊に届く仕様書と時間差があって、マイナーバージョンで５ぐらい遅れているのだ。そのくせテスト時には、俺たちブロックにバグが多い事を責め立てられる。」http://mssi.blog29.fc2.com/blog-entry-830.html [fc2.com]
最新仕様と同期していないドキュメントは、不要と言うか有害だからね。同期できないならソースのみでいいよ。あ、テストは最新化してくれ。それが仕様として見やすい。
より多くのコメントがこの議論にあるかもしれませんが、JavaScriptが有効ではない環境を使用している場合、クラシックなコメントシステム(D1)に設定を変更する必要があります。
コンピュータは旧約聖書の神に似ている、規則は多く、慈悲は無い -- Joseph Campbell
だからドキュメントを書けと (スコア:0)
「お渡ししたコードの動作が仕様です」
「あ、でもそのコードにはバグがあります」
それは問題の本質ではない (スコア:3, 興味深い)
「今回はメンテナンスしやすいようにと思い、ドキュメントは沢山書かせました。」
「ただしドキュメントとソースは一致していません。」
「ドキュメントも毎日の様に変更されたので、どのバージョンに準拠して書かれたコードなのかは誰にも分かりません。」
「ドキュメントに含まれてない仕様も多数存在します。」
「また、その分コードを書く時間が減って、コメントとかデバッグの時間が無くなりました。」
プログラムを書いたことがない素人ほど、ドキュメントで問題解決できると勘違いするんだよね。
「しかし、情報が依然まともに伝わって来ないし行かないので、デバッグはなかなか進まなかった。
隣の部隊に届く仕様書と時間差があって、マイナーバージョンで５ぐらい遅れているのだ。
そのくせテスト時には、俺たちブロックにバグが多い事を責め立てられる。」
http://mssi.blog29.fc2.com/blog-entry-830.html [fc2.com]
Re: (スコア:0)
最新仕様と同期していないドキュメントは、不要と言うか有害だからね。
同期できないならソースのみでいいよ。
あ、テストは最新化してくれ。それが仕様として見やすい。