伝わるコードレビュー 開発チームの生産性を高める「上手な伝え方」の教科書
発売日:2025年4月
- ページ数
- 211p
- ISBN
- 978-4-7981-8600-9
- 著者情報
- 鳥井 雪(トリイ ユキ)
プログラマー、NPO法人Waffleカリキュラム・マネージャー、万葉フェロー。令和5年度版東京書籍の国語教科書にプログラミングに関する文章掲載。Rails Girls TokyoやNPO法人Waffle等において女性や初学者のための活動経験多数。2024年Forbes JAPAN「Women In Tech 30:テクノロジー領域で未来を創造する30人の女性」選出
久保 優子(クボ ユウコ)
2007年に大場寧子とともに株式会社万葉を創業し、副社長COOとして営業を一手に担っている。元Railsエンジニア
諸永 彩夏(モロナガ アヤカ)
株式会社万葉に所属するプログラマー。万葉入社前はカスタマーサポートや経理・人事職をしていたが、プログラミングに興味を持ち学習を始めた。その後2020年2月万葉へ入社。入社後、研修や様々なプロジェクトでのチーム開発を通してテキストコミュニケーションを学ぶ
島田 浩二(シマダ コウジ)
1978年神奈川県生まれ。電気通信大学電気通信学部情報工学科卒。2009年に株式会社えにしテックを設立。2011年からは一般社団法人日本Rubyの会の理事も務める
セブン-イレブン受取り(送料無料)
発送目安
発売日(発売日以降は当日)~2日で発送
宅配(送料¥550税込)
発送目安
発売日(発売日以降は当日)~2日で発送
交通状況・天候の影響や注文が集中した場合等、お届けにお時間をいただく場合がございます。
商品説明
コメントひとつで、開発はスムーズになる。“すぐに”“明確に”“ストレスなく”伝わるプルリクエスト・レビューコメントの書き方がわかる!19の課題シーン/33のTIPSで学ぶ。
コードレビューを円滑に進めたいあなたへ。
効率的なテキストコミュニケーションの技法を身につけよう。
コードレビューは、チームで開発するプロダクトの品質を高める重要なプロセスです。しかし、オンライン上のテキストコミュニケーションが基本となるコードレビューでは、「意図が正しく伝わらない」「受け手がネガティブに受け取ってしまう」などのすれ違いが頻発し、手戻りや誤解を生んでしまうことも少なくありません。
本書は、そんな意図や感情のすれ違いを起こさない「伝わるコードレビュー」の技法を解説した書籍です。具体的な19の事例シーンをもとに、わかりやすいプルリクエスト・レビューコメントの書き方や効果的なレビューの進め方を詳しく解説します。
事例シーンは、
・緊張感のあるレビューコメントが返ってきたとき
・説明不足のPRが提出されたとき
・考え方や価値観が食い違ったとき
など、開発現場のコードレビューでよくあるミスコミュニケーションのケースを収録。かわいいキャラクターとともに、問題の原因と対策を整理し、実践的な解決アプローチを提案します。
「レビューのつもりが指摘合戦になってしまう」
「何を伝えたいのかわからないコメントが飛び交ってしまう」
そんな悩みを抱える開発チームにとって、本書はよりよいコードレビューの指針を示すガイドラインになるはずです。レビューの指摘が的確に伝わり、レビューを受ける側も納得感をもって改善できる―そんなスムーズなコードレビューの技法を、本書で身につけましょう。
■解説TIPS(一部)
クイズを出さない/性善説で考える/チームで共有するタグを作る/作業ログをつけて参照場所をリンクする/相談までの時間を決める/わからないレベルを伝える/自分の考え・意見を添える/詳細を明示する/「念のため」の確認をする/上手に催促する/聞きたいことを絞る/Before/Afterの画像を載せる/テンプレートを用意する/ラベルをつける……他、多数の実践的なTIPSを収録!
■対象読者
・コードレビューのよりよいやり方を知りたい現場のエンジニア、メンター
・チーム全体でコードレビューの指針を整えたいリーダー・マネージャー
・はじめてコードレビューをする新人エンジニア
目次
【Part1 心構え編】
・「伝わるコードレビュー」とは
-この本は何のための・どのような本か
-コードレビューの利点と難しさ
-コードレビューはコミュニケーション
・伝わるコードレビューの5大ルール
-コードレビューで守るべきルール
-ルール(1):決めつけない
-ルール(2):客観的な根拠に基づく
-ルール(3):お互いの前提知識を揃える
-ルール(4):チームで仕組みを作る
-ルール(5):率直さを心がける
-コードレビューは双方向のコミュニケーション
【Part2 実践編】
Case1:緊張感のあるレビューコメント
Case2:説明不足のPR
Case3:進捗が遅れているPR
Case4:考え方・価値観の食い違い
Case5:細かすぎるレビューコメント
Case6:Lintツールの言いなりの修正
Case7:「あの人が言っているから大丈夫」という思考停止
Case8:質問コメントに答えない修正PR
Case9:レビューポイントがわかりにくいPR
Case10:気を遣いすぎたレビューコメント
Case11:レビューされないPR
Case12:前提が揃っていないPR
Case13:コメントへの訂正情報の不足
Case14:放置された議論
Case15:見過ごされた質問コメント
Case16:想像に基づく修正
Case17:調べる前に相手に投げてしまう質問
Case18:関係者へ確認ができていないPR
Case19:感情的なコメント
ほか
商品詳細
- 出版社名
- 翔泳社
- サイズ
- 21cm
- 対象年齢
- 一般
- フォーマット
- 単行本
注意事項
- 本の帯に関して
- 帯つきでの出荷はお約束しておりません。
商品ページに、帯のみに付与される特典物等の表記がある場合でも、確実に帯つきでの出荷はお約束しておりません。
また、帯は商品の一部ではなく「広告扱い」のため、帯の有無・破損による交換や返品は承っておりません。 - 版・表紙について
- 版・表紙(カバー)のご指定は承っておりません。ご注文いただくタイミングによっては、お届けする商品の版や表紙が商品ページ上のものとは異なる場合がございます。
また、初版にのみにお付けしている特典(初回特典、初回仕様特典)がある商品は、商品ページに特典の表記がされている場合でも、無くなり次第終了となります。