良いドキュメント・マニュアル・仕様書を書くスレat TECH良いドキュメント・マニュアル・仕様書を書くスレ - 暇つぶし2ch■コピペモード□スレを通常表示□オプションモード□このｽﾚｯﾄﾞのURL■項目テキスト601:デフォルトの名無しさん 08/05/30 13:08:41 システムハンガリアンを止めて、アプリケーションハンガリアンにする。 602:デフォルトの名無しさん 08/05/31 00:23:06 >>599 > 特にリリース後の修正箇所に対して正確な > コメントが書かれているソースが本当に少ない。 これはコミットログやChangeLogの役目だろう 603:デフォルトの名無しさん 08/05/31 13:13:14 > これはコミットログやChangeLogの役目だろう ソース内のロジックとコメントは分業してるってこと？ ロジックとそのコメント内容が一致してないから 障害対応してるときに頭からソースを読まなければ ならないってこと。 そして、修正したPGはすでにいないことが多い・・・・ 604:デフォルトの名無しさん 08/05/31 17:32:04 コメントとソースを同じくらい価値があるものだと考えるのはいいが コメントとソースを同じように扱ってはいけないだろ 605:デフォルトの名無しさん 08/05/31 18:51:02 そこまでコメントに期待してないよ。 ただ最初にも書いたけど、表題部の プログラム名や用途、引数説明すら まともに書いてないソースが多すぎる からカキコしただけだ 次ページ最新レス表示レスジャンプ類似スレ一覧スレッドの検索話題のニュースおまかせリストオプションしおりを挟むスレッドに書込スレッドの一覧暇つぶし2ch