アカウント名:
パスワード:
ドキュメントのまとめ方である程度傾向は判断出来る詳細仕様・テスト仕様の改版履歴とレビュー結果報告だけでも見ればずいぶん傾向は見える。更にchangelogを見せてもらえれば言う事無し。
それだね。ドキュメントがちゃんとしていればある程度以上の質が保たれてる可能性が高い。酷いところはドキュメントが存在しない・初版から更新されていないもあるけど、その場合はコードの質も素人以下
Q「ドキュメントに書いてある内容と挙動が違うんだけど?」A1「そのドキュメントは旧版です。最新版はコードを参照して下さい。」A2「ドキュメントは設計書ですが、実装にはバグがあって、その通りには実装されていません。」A3「その機能はまだ実装されていません。次のフェーズ3以降で実装する予定です。」#なれるSEでもそんなネタがあったなあ。
前任者はコードもドキュメントもほぼ完璧だったけど、不況のあおりで前任者がクビにされて、現在の担当は一切コメントもドキュメントも書かずに、バグフィックスや機能追加、リファクタリングと称してスパゲッティプログラムを大量生産。
……という可能性も無いとは言えない。#ユニットテストも無しでCのスパゲッティプログラムを書き換えるのを「リファクタリング」と#称してる奴がいたなあ。死ねば良いのに。
特に中小企業だと、作ってるのが実質一人だったりするからなあ。その担当がクビにされた後を引き継ぐのが未経験の新人だったりすると、こういうことは十分起こりえる。
より多くのコメントがこの議論にあるかもしれませんが、JavaScriptが有効ではない環境を使用している場合、クラシックなコメントシステム(D1)に設定を変更する必要があります。
犯人は巨人ファンでA型で眼鏡をかけている -- あるハッカー
例外もかなり多いけど (スコア:5, 興味深い)
ドキュメントのまとめ方である程度傾向は判断出来る
詳細仕様・テスト仕様の改版履歴とレビュー結果報告だけでも見ればずいぶん傾向は見える。
更にchangelogを見せてもらえれば言う事無し。
Re: (スコア:0)
それだね。ドキュメントがちゃんとしていればある程度以上の質が保たれてる可能性が高い。
酷いところはドキュメントが存在しない・初版から更新されていないもあるけど、その場合はコードの質も素人以下
Re: (スコア:0)
ドキュメントがまともでなくても、コードだけで完結してる例もある。
Re:例外もかなり多いけど (スコア:1)
Q「ドキュメントに書いてある内容と挙動が違うんだけど?」
A1「そのドキュメントは旧版です。最新版はコードを参照して下さい。」
A2「ドキュメントは設計書ですが、実装にはバグがあって、その通りには実装されていません。」
A3「その機能はまだ実装されていません。次のフェーズ3以降で実装する予定です。」
#なれるSEでもそんなネタがあったなあ。
前任者はコードもドキュメントもほぼ完璧だったけど、不況のあおりで前任者がクビにされて、
現在の担当は一切コメントもドキュメントも書かずに、バグフィックスや機能追加、リファクタリングと
称してスパゲッティプログラムを大量生産。
……という可能性も無いとは言えない。
#ユニットテストも無しでCのスパゲッティプログラムを書き換えるのを「リファクタリング」と
#称してる奴がいたなあ。死ねば良いのに。
特に中小企業だと、作ってるのが実質一人だったりするからなあ。
その担当がクビにされた後を引き継ぐのが未経験の新人だったりすると、
こういうことは十分起こりえる。