추천 검색어

최근 검색어

도서 IT전문서/IT입문서 IT교양
19가지 사례와 33가지 팁으로 배우는 개발자 말하기와 글쓰기, 좋은 개발팀은 어떻게 리뷰하고 소통하는가? 좋은 코드 리뷰 나쁜 코드 리뷰
정 가
22,000원
출 간
2026-08-25
지 은 이
토리이 유키,쿠보 유코,모로나가 아야카
옮 긴 이
김성훈
I S B N
9791140720125
분 량
212쪽
난 이 도
관계없음

19가지 사례와 33가지 팁으로 배우는 개발자 말하기와 글쓰기, 좋은 개발팀은 어떻게 리뷰하고 소통하는가?

코드 리뷰는 단순히 버그를 찾거나 잘못된 코드를 지적하는 과정이 아닙니다.

좋은 코드 리뷰는, 코드의 품질을 높이는 동시에 지식을 공유하고 개발자와 팀을 함께 성장시키는 중요한 협업 과정입니다.

 

 

이 책은 오랫동안 코드 리뷰를 개발 문화와 팀 육성의 핵심으로 실천해 온 일본의 개발회사 만요(万葉)의 실무자들이 모여 만든 책입니다. 만요는 코드 리뷰를 개발 프로세스와 사내 교육에 적극적으로 활용해왔습니다. 그 목적 또한 단순한 버그 발견에 두지 않고 코드 품질 향상과 지식 공유, 다양한 선택지에 대한 논의와 합의, 개발자의 기술력 향상과 팀의 성장을 위한 중요한 과정으로 코드 리뷰를 바라봅니다. 이러한 철학을 바탕으로 15년 이상 코드 리뷰를 실천하며 경험과 노하우를 축적해 왔습니다.

이 책 또한 이상적인 원칙이나 이론이 아닌, 실제 개발 현장에서 수많은 코드 리뷰를 주고받으며 쌓은 시행착오와 팀 운영 경험을 바탕으로, 현장에서 바로 적용할 수 있는 코드 리뷰 방법을 구체적인 사례와 함께 설명합니다. 특히 리뷰 과정에서 발생하는 오해와 갈등, 질문과 설명, 피드백과 논의 등 사람과 협업에 초점을 맞춘 리뷰 기술을 다룹니다. 코드 리뷰가 부담스러운 주니어부터 리뷰의 품질을 높이고 싶은 시니어, 더 나은 개발 문화를 만들고 싶은 팀 리더까지, 좋은 코드와 좋은 개발팀을 함께 만들어 가고 싶은 모든 개발자를 위한 실전 코드 리뷰 가이드입니다.

 

PART 1 마음가짐

전달력 있는 코드 리뷰란?

전달력 있는 코드 리뷰의 5대 원칙

 

 

PART 2 실전

Case 1 긴장감 넘치는 리뷰 코멘트

Case 2 설명이 부족한 PR

Case 3 진행이 더딘 PR

Case 4 사고방식이나 가치관의 차이

Case 5 지나치게 자세한 리뷰 코멘트

Case 6 Linter에 의존한 수정

Case 7 ‘그 사람이 말했으니 괜찮지’라는 사고 금지

Case 8 질문 코멘트에 답하지 않은 수정 PR

Case 9 리뷰 포인트를 이해하기 어려운 PR

Case 10 지나치게 눈치를 보는 리뷰 코멘트

Case 11 리뷰되지 않은 PR

Case 12 사전 조건이 명확하지 않은 PR

Case 13 코멘트에 대한 정정 정보 부족

Case 14 방치된 논의

Case 15 놓친 질문 코멘트

Case 16 상상에 기반한 수정

Case 17 찾아보지도 않고 하는 질문

Case 18 관계자에게 확인하지 않은 PR

Case 19 감정적인 코멘트

 

 

PART 3 TIPS

TIP 01 퀴즈를 내지 않는다

TIP 02 명령하지 않는다

TIP 03 성선설을 바탕으로 생각한다

TIP 04 상대방의 의도를 단정하지 않는다

TIP 05 우선은 공감을 표현한다

TIP 06 팀에서 공유할 태그를 만든다

TIP 07 Linter를 도입한다

TIP 08 작업 로그를 남기고 참조 위치를 링크한다

TIP 09 상담하는 시점을 정해 둔다

TIP 10 막힌 상황을 전달한다

TIP 11 이해 수준을 전달한다

TIP 12 돌려 말하지 않는다

TIP 13 자신의 생각과 의견을 덧붙인다

TIP 14 근거가 없다면 없다고 덧붙인다

TIP 15 상세 정보를 명시한다

TIP 16 무엇을 해 주길 원하는지 전달한다

TIP 17 만일을 위해 다시 한 번 확인한다

TIP 18 채팅에서 대화로 전환한다

TIP 19 질문 상대를 명시한다

TIP 20 효과적으로 재촉한다

TIP 21 기한을 명시한다

TIP 22 바로 답변할 수 없음을 전달한다

TIP 23 질문을 좁힌다

TIP 24 상대방의 지식 수준에 맞춘다

TIP 25 예/아니오로 답변받는다

TIP 26 목표는 이기는 게 아니라 납득시키는 것이다

TIP 27 Before/After 이미지를 이용한다

TIP 28 하지 않은 것을 기술한다

TIP 29 템플릿을 준비한다

TIP 30 레이블을 붙인다

TIP 31 목록 형식을 사용한다

TIP 32 리뷰어 지명 로직을 만든다

TIP 33 상대방의 이해 단계에 따라 진행한다

 

 

감수자 후기

TIPS 대응표

 

 

 

ㆍ지은이 토리이 유키
소개
프로그래머, NPO 법인 Waffle 커리큘럼 매니저, 만요 펠로우. 저서로는 『유우와 마법 프로그래밍 노트』(오라일리 재팬)가 있으며, 번역서로는 『루비의 모험』(쇼에이사), 『프로그래밍 Elixir』(옴사, 사사다 코이치 공역) 등이 있다. 2023년도 도쿄서적 국어 교과서에 프로그래밍 관련 글이 실렸다. Rails Girls Tokyo 및 NPO 법인 Waffle 등에서 여성과 초보자를 위한 활동 경험 다수. 2024년 포브스 재팬 'Women In Tech 30: 테크놀로지 분야에서 미래를 창조하는 30인의 여성'에 선정되었다.

ㆍ지은이 쿠보 유코
소개
2007년 오바 야스코와 함께 주식회사 만요를 창업했으며, 부사장 겸 COO로서 영업 업무를 도맡고 있다. 전직 Rails 엔지니어로, 공저로 『Ruby on Rails 문제 해결 퀵 레퍼런스』(마이니치 커뮤니케이션즈)가 있다. 취미는 튜바와 알토색스폰이다.

ㆍ지은이 모로나가 아야카
소개
주식회사 만요 소속 프로그래머. 만요 입사 전에는 고객 지원과 회계·인사 업무를 담당했으나, 프로그래밍에 흥미를 느껴 학습을 시작했다. 2020년 2월 만요에 입사했으며, 입사 후에는 연수와 다양한 프로젝트에서 팀 개발을 통해 텍스트 커뮤니케이션을 익혔다.

ㆍ옮긴이 김성훈
소개
현재 컴퓨터 기술 분야 번역을 주로 한다. 평소 관심 분야는 IT 기술 동향과 어학 교육 콘텐츠 기획 등이며, 최근에는 macOS 및 iOS를 기반으로 작업 환경을 바꾸고 더 나은 작업 방법을 찾는 중이다. 주요 번역서로는 『그림으로 배우는 스프링6 입문』(한빛미디어, 2024), 『따라 하며 배우는 언리얼 엔진 5 입문』(한빛미디어, 2024), 『그림으로 배우는 5G 네트워크』(영진닷컴, 2022), 『그림으로 이해하는 IT 지식과 트렌드』(길벗, 2021), 『파이썬으로 배우는 머신 러닝 입문』(성안당, 2021), 『Scratch가 보이는 그림책』(성안당, 2020), 『C가 보이는 그림책』(성안당, 2018), 『실무에서 바로 통하는 자바』(한빛미디어, 2017), 『안드로이드 개발 레벨업 교과서』(위키북스, 2017), 『24가지 예제로 배우는 게임 수학&물리 입문』(길벗, 2014), 『세가의 신입사원 교육 과정에서 배우는 게임 프로그래밍의 정석』(한빛미디어, 2012), 『웹 개발자를 위한 웹을 지탱하는 기술』(멘토르, 2011) 등이 있다.

ㆍ감수 시마다 고지
소개
1978년 가나가와현 출생. 전기통신대학 전기통신학부 정보공학과 졸업. 2009년에 주식회사 에니시테크를 설립. 2011년부터는 일반사단법인 일본 Ruby 협회의 이사도 맡고 있다. 최근 번역서로는 『소프트웨어 아키텍트를 위한 의사결정 기법』(인프레스), 『스태프 엔지니어의 길』(오라일리 재팬), 『소프트웨어 아키텍처 메트릭스』(오라일리 재팬) 등이 있다.

필요한 자료를 선택하세요.

추천도서