エンジニアtype - エンジニアのシゴト人生を考えるWebマガジン
  • TOP
  • キーパーソン
  • 旬ネタ
  • コラボ
  • ノウハウ
  • 女子部
  • キャリア

同僚の外国人にコードレビューをお願いするには……【連載:コピペで使えるIT英語tips】

タグ : IT, tips, コードレビュー, メール文, 外国人, 英語 公開

 

ソフトウエアの開発工程中に紛れ込んだバグを洗い出すために行われる「コードレビュー」。

自分自身でコードレビューツールやプラグインなどを使って自己完結しているエンジニアも多いだろうが、やはり上司や同僚にレビューしてもらった方が、実装技術の向上や他人のコードを読むことでスキルアップにつながるなど利点も多い。

最近では、開発体制の国際化に伴い、外国人にコードレビューをお願いする機会が増えているエンジニアもいるはずだ。

そこで今回は、シンガポールで働く日本人エンジニアのDさんに、同僚の外国人にコードレビューを依頼するときの表現について紹介していただいた。

依頼する内容は日本語と同様、項目・終了希望日など

【冒頭】

Hi, ◎◎◎
(訳)◎◎◎様

冒頭の書き方については「海外企業に、メールで製品の問い合わせをするには【連載:コピペで使えるIT英語tips】」を参照しよう。

【本文】

Now that the source code has been completed, I would like you to review my code along the following point of view.

-Is the code easy to read?
-Isn’t there a simple mistake such as a mistake in grammar?
-Is it built to the specifications?
-Is the description appropriate for things like error handling?
-Is the name of the function and variable suitable?

(訳)
ソースコードがそろったので、下記の観点に沿ってコードレビューをお願いしたいと思います。

・コードは読み易いですか?
・文法ミスなどの単純ミスはありませんか?
・仕様通りに作り込まれていますか?
・エラー処理などの記述は適切ですか?
・関数や変数の名前は適切ですか?

コードレビューをお願いする際には、どういう観点でコードレビューをしてほしいかを伝えておくとベター。上記のような箇条書きで示すと伝わりやすい。

【結び】

I would appreciate it if you finish the code review by (日付).
Please let me know if you have advice or questions.

Best regards,
◎◎◎

(訳)(日付)までにコードレビューを終了してもらえるとうれしいです。アドバイスや疑問点があったら教えてください。
ご返信お待ちしております。◎◎◎より

納品やローンチのスケジュールから逆算して「いつまでにコードレビューを終えてほしい」と伝えておこう。

コードは「世界共通言語」

できれば、上記の文面に加え、自分のコードを自分の言葉で説明できればよりよいが、英語が苦手な人にとっては敷居が高いと感じるはずだ。

しかし、たとえ英語が不得手であっても、コードは「世界共通言語」。その共通言語の使い手同士なのだから、ちょっとした勇気さえあれば、自ずとコミュニケーションは取れるはず」とDさんは言う。

「コードを見ればその人の特徴やクセだけでなく性格も分かる」というエンジニアは少なくない。たとえ相手が外国人であっても、それはおそらく変わらないはずだ。

コードレビューを通して、バグの洗い出しとスキルアップに加え、プログラマー同士の相互理解が深められるなら、まさに一石二鳥。特に初めて一緒にプロジェクトを手掛ける外国人とは、できるだけ早い段階で、互いにコードレビューを行ってみることをお勧めしたい。

取材・文/大井 あゆみ(『シンガポール経済新聞』運営Diversolutions.Ptd.Ltd代表取締役)
編集協力/岡 徳之(Noriyuki Oka Tokyo




人気のタグ
業界有名人 スタートアップ 開発 SE 転職 エンジニア プログラマー Web スキルアップ ソーシャル アプリ シリコンバレー キャリア プログラミング Android 起業 えふしん スマートフォン アプリ開発 SIer 技術者 UI btrax Webサービス クラウド Apple スペシャリスト CTO Twitter Brandon K. Hill ギーク 英語 村上福之 Facebook Google デザイン IoT SNS ツイキャス 世良耕太 モイめし IT 30代 採用 赤松洋介 コーディング 20代 UX 勉強会 プロジェクトマネジメント Ruby ITイベント Webエンジニア 中島聡 ビッグデータ 法林浩之 ウエアラブル iOS 五十嵐悠紀 LINE ドワンゴ ひがやすを ロボット 受託開発 モノづくり IT業界 コミュニケーション イノベーション ハードウエア MAKERS tips ゲーム 女性 ソーシャルゲーム Webアプリ SI インフラ iPhone 女性技術者 高須正和 マイクロソフト 研究者 UI/UX トヨタ 自動車 ノウハウ チームラボ 息抜き システム ソニー プラットフォーム Java メイカームーブメント オープンソース 和田卓人 エンジン グローバル 開発者 教育 イベント サイバーエージェント ソフトウェア 女子会 コミュニティ メーカー 家入一真 スーパーギーク 増井雄一郎 GitHub 人工知能 IPA 40代 日産 テスト駆動開発 ソフトウエア 音楽 TDD ニュース モバイル PHP TechLION

タグ一覧を見る