良いドキュメント・マニュアル・仕様書を書くスレat TECH良いドキュメント・マニュアル・仕様書を書くスレ - 暇つぶし2ch■コピペモード□スレを通常表示□オプションモード□このｽﾚｯﾄﾞのURL■項目テキスト600:デフォルトの名無しさん 08/05/30 04:18:14 変数名自体を説明にするしかない 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 コメントとソースを同じくらい価値があるものだと考えるのはいいが コメントとソースを同じように扱ってはいけないだろ 次ページ最新レス表示レスジャンプ類似スレ一覧スレッドの検索話題のニュースおまかせリストオプションしおりを挟むスレッドに書込スレッドの一覧暇つぶし2ch