Wednesday, April 22, 2009

How to review others' code?

最近在思考如何才能高效地完成review,让review不要变成形式化的空架子。

programming4scientists 上看到一个how to review code 的一篇博文。

关于review,有以下六点:

1. 首先需要对要review的东西有一个全局的认识。如果代码已经差不多完成,则对于架构层面、设计层面的改动则很少会发生因为这样代价很高;反之如果是设计阶段,则指出的问题便多多益善。

2. 必须提有建设性的意见。不只要指出问题,还有提出问题的解决办法。如果有bug,提出解决方案;如果代码风格方面意见,给出更好的风格以及why。

3. 问。会碰到很混乱或者含糊不清的代码,通常这种情况下,作者对这一块也会没有很清晰的认识,问他们,使他们思考,从而建立清晰的认识。

4. 代码风格是非常私人化的,除非非常不协调或者晦涩难懂,不要吹毛求疵。给出建议和解释为什么更好。

5. 跟随你的直觉,如果你有非常多的经验,你会“嗅到”坏代码,当然这种能力或者说本能是随着经验的不断丰富而形成的。

6. 不要将自己的意见强加给作者。你只是给建议,而不是接管编码权。

anything else ?

-----------------------------------------------
usernet上得到一些反馈,再补上以下四条:

7. Review meeting最好安排有专门的Moderator,控制整个Review过程:比如会议室的预定;会议时间的掌控等。

8. Reviewer的指定必须有针对性:他必须对你的代码流程比较熟悉,最好是一个项目组的同事。

9. 如果有测试报告,最好把测试报告也作为Review的对象。

10. 必须有一个书面性的东西追踪你的review和work after review。

17 comments:

逆円助 said...
This comment has been removed by a blog administrator.
精神年齢 said...

みんなの精神年齢を測定できる、メンタル年齢チェッカーで秘められた年齢がズバリわかっちゃう!かわいいあの子も実は精神年齢オバサンということも…合コンや話のネタに一度チャレンジしてみよう

メル友募集 said...

最近仕事ばかりで毎日退屈してます。そろそろ恋人欲しいです☆もう夏だし海とか行きたいな♪ k.c.0720@docomo.ne.jp 連絡待ってるよ☆

家出 said...

最近TVや雑誌で紹介されている家出掲示板では、全国各地のネットカフェ等を泊り歩いている家出娘のメッセージが多数書き込みされています。彼女たちはお金がないので掲示板で知り合った男性の家にでもすぐに泊まりに行くようです。あなたも書き込みに返事を返してみませんか

動物占い said...

あなたの性格を、動物に例えて占っちゃいます。もしかしたらこんな動物かも!?動物占いをうまく使って、楽しい人間関係を築いてください

家出 said...

家出中の女性や泊まる所が無い女性達がネットカフェなどで、飲み放題のドリンクで空腹を満たす生活を送っています。当サイトはそんな女性達をサポートしたいという人たちと困っている女性たちの為のサイトです

セレブラブ said...

セレブ女性との割り切りお付き合いで大金を稼いでみませんか?女性に癒しと快楽、男性に謝礼とお互い満たしあえる当サイト、セレブラブはあなたの登録をお待ちしております。

夏フェス!! said...

夏フェス一緒に行ってくれる人募集!!夏の思い出一緒につくろぉ☆ megumi-0830@docomo.ne.jp 連絡してね♪

無料ゲーム said...

あなたのゲーマー度を無料ゲーム感覚で測定します。15個の質問に答えるだけの簡単測定で一度遊んでみませんか?ゲームが得意な人もそうでない人もぜひどうぞ。

素人 said...

Hな女性たちは素人ホストを自宅やホテルに呼び、ひとときの癒しを求めていらっしゃいます。当サイトでは男性ホスト様の人員が不足しており、一日3~4人の女性の相手をするホストもおられます。興味を持たれた方は当サイトにぜひお越しください

出会い系 said...

実は出会い系には…関係者用入り口があるのを知っていますか?広告主やスポンサー用に用意されたIDではサクラや業者が立ち入ることが出来ないようになっているのです。当サイトでは極秘に入手した関係者用URLが公開されています

逆援助 said...

男性はお金、女性は快楽を得る逆援助に興味はありませんか?お金を払っても性的欲求を満たしたいセレブ達との割り切り1日のお付き合いで当サイトでは大金を得ることができます。無料登録なのでアルバイト感覚でOK、詳しくはTOPページでどうぞ。

友達募集 said...

ホムペ完成記念!私の事みんなに知ってもらいたくて頑張りましたぁ。色々とご感想をお待ちしているので思った事を意見してください。メアドはほむぺにのせてありますぅ!★ fan.jna@docomo.ne.jp

家出 said...

夏休みで気軽に家出する女子○生が急増しています。しかし家出したはいいものの泊る所やお金が無い彼女たちは、掲示板などで泊めてくれる男性を探す子も多いようです。当掲示板にも夏休みに入ってから通常の3倍以上のメッセージが寄せられています

人妻 said...

今最もアツイバイトは人妻とのセフレ契約です。当サイトではお金を払ってでもセフレがほしい人妻が集まり、男性会員様との逆援生活を待っています。当サイトで欲求不満の女性との出会いをしてみませんか

素人 said...

素人ホストでは、男性のテクニック次第で女性会員様から高額な謝礼がもらえます。欲求不満な人妻や、男性と出会いが無い女性達が当サイトで男性を求めていらっしゃいます。興味のある方はTOPページからどうぞ

友達募集中 said...

少し魅惑な自分をネットだから公開してみました。普段言えない事など、思い切って告白しているプロフなので興味ある方はぜひ除いてみてください連絡待ってまぁす。 hinyaaaaa@docomo.ne.jp