中の技術日誌ブログ

C#とC++/CLIと
VBと.NETとWindowsで戯れる
 

目次

Blog 利用状況

ニュース

自己紹介

東京でソフトウェアエンジニアをやっています。
お仕事大募集中です。
記事執筆や、講師依頼とかでも何でもどうぞ(*^_^*)
似顔絵 MSMVPロゴ
MSMVP Visual C# Since 2004/04-2013/03

記事カテゴリ

書庫

日記カテゴリ

00-整理

01-MSMVP

他人のソースって

いつも思うことだが、他人のソースを見ていると大体以下の作業が必須

  • コメントを書く

まず大体コメントが少ないことがほとんど

作っている時はわかっても後で自分が見てもわからなくなるんだから、きっちりコメント書くべし。

  • 無駄なコメントアウトを削除する

コメントアウトは削除するべし。これはただgrepを汚すごみでしかない。

大体が"使うかも~", "履歴が~"っていうのなら、マイルストーンの退避ソースから持ってくれば良いわけで・・・

  • 関数名/変数名を変更する

関数名や変数名にxxxx1とかxxx2とかじゃ何をしているかわからない。

過去にも2~3人以上の人の手を経由してやってきたソースをメンテしたりしたけど、意図を必ずソースや仕様書に書かないと事象を書いてもわからないことが多い。

そういう意味でやっぱりWhy中心主義を唱えないといけないよね。

投稿日時 : 2005年11月27日 22:16

コメントを追加

# re: 他人のソースって 2005/11/28 11:46 じゃんぬ

確かにリファクタリングからスタートしますね。
あまりに酷い場合は作り直しをを検討します。

でも稼動しているとなると、強制的に修正になるのがつらいところですね。

よく動いてるよなーなんて感心することがしばしば...

# re: 他人のソースって 2005/11/28 12:41 岡部@コア

中さんが書かれてある作業は、必須作業だと思ってました。w
って、そういうのがダメなんだろうな。ちゃんとフィードバックせねば・・・_| ̄|○

# re: 他人のソースって 2005/11/30 0:16 esumi

そして問題のソースコードを担当した開発責任者が
退職とかすると、当該アプリが社内ブラックボックスと化すわけですな。オソロシイコトデス…

VS2005のリファクタリング機能は開発時の勢いで記述した
コードをかなり解読しやすくする助けになりそうなので
ベータと戯れつつ、12月15日の日本語版登場を心待ち
にしておりまス。

まあどのみち他人様の書いたコードなんてできれば
読みたく無いのは同じなのですケド(笑)

機能の詳細だけしか記述されてない仕様書が
回ってくるたび、まだ一行もコード書かないうち
からメンテ時の事を思い、気が重くなります(汗)

タイトル
名前
URL
コメント