「引き継いだプログラム、「自分のもの」にするには ?」記事へのコメント

だからドキュメントを書けと

[Anonymous Coward]

『仕様書はありますか？』
「お渡ししたコードの動作が仕様です」

「あ、でもそのコードにはバグがあります」

それは問題の本質ではない

[firewheel (31280)]

「今回はメンテナンスしやすいようにと思い、ドキュメントは沢山書かせました。」
「ただしドキュメントとソースは一致していません。」
「ドキュメントも毎日の様に変更されたので、どのバージョンに準拠して書かれたコードなのかは誰にも分かりません。」
「ドキュメントに含まれてない仕様も多数存在します。」
「また、その分コードを書く時間が減って、コメントとかデバッグの時間が無くなりました。」

プログラムを書いたことがない素人ほど、ドキュメントで問題解決できると勘違いするんだよね。

「しかし、情

Re:それは問題の本質ではない

[Anonymous Coward]

最新仕様と同期していないドキュメントは、不要と言うか有害だからね。
同期できないならソースのみでいいよ。
あ、テストは最新化してくれ。それが仕様として見やすい。