홈앤서비스 SK BROADBAND

옮긴이 머리말 xi
추천의 글 xiii
베타리더 후기 xvi
추천 서문 xviii
시작하며 xx
감사의 글 xxii
이 책에 대하여 xxiv
표지에 대하여 xxvii

PART I 코드 리뷰의 기초 지식

CHAPTER 1 코드 리뷰의 중요성 3
1.1 대상 독자 7
1.2 책의 구조 9
1.3 코드 리뷰가 필요하다 11
__1.3.1 더 나은 애플리케이션 11
__1.3.2 팀의 이해 수준 향상 12
1.4 팀 설득하기 12
1.5 코드 리뷰 개선하기 13
요약 14

CHAPTER 2 코드 리뷰 분석하기 15
2.1 코드 리뷰 시스템 15
__2.1.1 사람 주도 16
__2.1.2 도구 기반 16
__2.1.3 혼합형 17
2.2 코드 리뷰는 어떻게 작동할까? 18
__2.2.1 현재의 코드 리뷰 워크플로 19
__2.2.2 우리의 코드 리뷰(PR 워크플로) 22
2.3 훌륭한 PR의 요소 22
__2.3.1 제목: ‘what’ 23
__2.3.2 디스크립션: ‘why’ 28
__2.3.3 레이블 34
__2.3.4 리뷰 상태 37
2.4 코드 리뷰 참여자와 기대사항 40
__2.4.1 리뷰어 41
__2.4.2 작성자 46
__2.4.3 팀 51
__2.4.4 관리자 53
__2.4.5 조직 54
요약 58

CHAPTER 3 팀의 첫 코드 리뷰 프로세스 구축하기 60
3.1 목표 설정하기 61
__3.1.1 버그 발견 61
__3.1.2 코드베이스의 안정성과 유지 보수성 63
__3.1.3 지식 전달과 정보 공유 64
__3.1.4 멘토링 67
__3.1.5 기록 보관/변경 이력 관리 68
__3.1.6 자신의 코드 리뷰 목표 선택하기 69
3.2 도구 선택하기 70
__3.2.1 코드 리뷰 기능 평가하기 71
__3.2.2 도구 선택하기 72
3.3 가이드라인 설정하기 76
__3.3.1 팀의 워크플로 76
__3.3.2 리뷰의 중점 79
__3.3.3 PR 승인을 막는 요인 80
__3.3.4 승인 정책 82
3.4 프로세스 개선하기 85
__3.4.1 개선 사례 가이드 88
요약 90

PART II 고급 코드 리뷰를 위한 필수 요소

CHAPTER 4 팀 워킹 어그리먼트 93
4.1 팀 워킹 어그리먼트란? 94
4.2 팀 워킹 어그리먼트로 팀 기대치 설정하기 94
__4.2.1 시나리오 1: 빠른 리뷰와 빠르지 않은 리뷰 95
__4.2.2 시나리오 2: 의미의 불일치 95
__4.2.3 시나리오 3: 승인 또는 미승인 97
4.3 팀 워킹 어그리먼트 수립하기 98
__4.3.1 팀에 팀 워킹 어그리먼트가 꼭 필요할까? 98
4.4 팀 워킹 어그리먼트에 포함할 사항 고려하기 102
__4.4.1 명확한 코드 리뷰 기대사항 102
__4.4.2 합리적인 응답 시간 102
__4.4.3 적절한 PR 크기 105
__4.4.4 문제 식별 106
__4.4.5 PR 셀프 승인하기 109
__4.4.6 사소한 지적 111
__4.4.7 긍정적인 리뷰 환경 112
__4.4.8 정책을 위반했을 때는 어떻게 할까? 113
4.5 팀 워킹 어그리먼트 적용하기 114
__4.5.1 수정이 필요할 때 114
__4.5.2 정리하기 115
요약 115

CHAPTER 5 자동화의 이점 117
5.1 자동화의 중요성 118
5.2 자동화의 전제 조건 120
__5.2.1 팀 스타일 가이드 120
__5.2.2 적절한 도구 123
5.3 리뷰 전 자동화 124
__5.3.1 포매팅 124
__5.3.2 린트 127
__5.3.3 정적 분석 129
__5.3.4 테스트 자동화 131
5.4 코드 리뷰 과정 중 자동화 133
__5.4.1 PR 템플릿 133
__5.4.2 PR 검증 도구 136
__5.4.3 리뷰어 할당 139
__5.4.4 PR 게이트 체크 143
__5.4.5 리마인더와 에스컬레이션 147
요약 148

CHAPTER 6 효과적인 코드 리뷰 코멘트 작성하기 150
6.1 코멘트를 효과적으로 만드는 방법 151
__6.1.1 객관성 151
__6.1.2 구체성 157
__6.1.3 명확한 결과 163
__6.1.4 효과적인 코드 리뷰 코멘트 샘플 165
6.2 말투(표현 방식) 167
6.3 코드 칭찬하기 171
요약 172

PART III 딜레마

CHAPTER 7 코드 리뷰가 망하는 순간들 177
7.1 코드 리뷰 프로세스에서 겪는 문제 178
__7.1.1 대충 진행하는 코드 리뷰 178
__7.1.2 나쁜 코드 리뷰 180
__7.1.3 일관성 없는 코드 리뷰 182
__7.1.4 엄격한 코드 리뷰 183
7.2 그렇다면 무엇을 해야 할까? 185
요약 185

CHAPTER 8 코드 리뷰 지연 줄이기 186
8.1 리뷰를 할 수 있는 시니어 개발자가 한 명밖에 없어요 187
8.2 PR이 이해되지 않아요 191
8.3 리뷰할 파일이 너무 많아요 192
8.4 기능이 너무 커서 리뷰가 어려워요 193
8.5 논의가 너무 길어지는 것 같아요 196
8.6 코드 리팩터링이 필요해요 199
요약 201

CHAPTER 9 프로세스의 허점 제거하기 203
9.1 허점이 발생하는 이유 203
9.2 허점(그리고 해결 방법) 204
__9.2.1 정의되지 않은 코드 리뷰 프로세스 205
__9.2.2 코드 리뷰 시간 부족 212
__9.2.3 도구의 (잘못된) 설정 214
__9.2.4 피드백 문화의 부재 215
__9.2.5 승인 지향 지표 217
__9.2.6 비상 상황 이용하기 220
요약 220

CHAPTER 10 비상 대응 매뉴얼 222
10.1 비상 대응 매뉴얼이 무엇일까? 223
10.2 비상 대응 매뉴얼의 필수사항 224
__10.2.1 의사결정 트리 224
__10.2.2 승인 프로세스 225
__10.2.3 우회 메커니즘 226
__10.2.4 다음 단계 227
10.3 언제 비상 대응 매뉴얼을 사용할까? 229
요약 229

CHAPTER 11 코드 리뷰와 페어 프로그래밍 233
11.1 코드 리뷰를 해야 할까, 페어 프로그래밍을 해야 할까? 234
__11.1.1 페어 프로그래밍으로 코드 리뷰 보완하기 235
__11.1.2 페어 프로그래밍이 코드 리뷰를 대체할 수는 없다 236
11.2 페어 프로그래밍을 프로세스에 통합하기 238
__11.2.1 페어 프로그래밍 시도를 위해 팀 설득하기 238
__11.2.2 페어 스타일 240
__11.2.3 효과적인 페어 프로그래밍을 위한 고려사항 243
요약 251

CHAPTER 12 코드 리뷰와 몹 프로그래밍 253
12.1 코드 리뷰 vs. 몹 프로그래밍 254
__12.1.1 몹 프로그래밍의 장점 255
__12.1.2 몹 프로그래밍으로 코드 리뷰 보완하기 257
__12.1.3 몹 프로그래밍은 코드 리뷰를 대체할 수 없다 259
12.2 몹 프로그래밍을 코드 리뷰와 통합하기 260
__12.2.1 상호 보완 접근 방식 261
__12.2.2 몹 프로그래밍의 핵심 요소 266
요약 269

CHAPTER 13 코드 리뷰와 AI 271
13.1 코드 리뷰에서 AI의 이점 272
__13.1.1 리뷰 속도 향상 272
__13.1.2 코드 품질 개선 273
__13.1.3 리뷰 일관성 274
__13.1.4 팀과 코드베이스의 규모에 영향을 받지 않는 리뷰 확장성 274
13.2 AI 코드 리뷰의 한계 274
__13.2.1 맥락과 도메인 지식 이해의 어려움 274
__13.2.2 학습 데이터에 크게 의존하는 성능 276
__13.2.3 AI에 과도한 의존은 리뷰어의 전문성을 저해할 수 있다 276
13.3 AI 기반 코드 리뷰가 무엇을 할 수 있을까? 277
13.4 AI를 코드 리뷰에 통합하기 287
13.5 코드 리뷰의 미래: 인간과 AI의 협업 289
요약 290

APPENDIX A 팀 워킹 어그리먼트 스타터 템플릿 294

APPENDIX B 비상 대응 매뉴얼 스타터 템플릿 300
B.1 비상 대응 매뉴얼 명명하기 300
B.2 의사결정 트리 300
B.3 승인 프로세스 301
B.4 우회 메커니즘(관련 작업) 301
B.5 다음 단계 302
__B.5.1 문서화 302
__B.5.2 커뮤니케이션 302
__B.5.3 사후 분석 303

APPENDIX C PR 템플릿 304

APPENDIX D 리소스 307
D.1 각 장의 리소스 리스트 307
D.2 언어별 린터 리스트 313
D.3 언어별 정적 분석 도구 318

APPENDIX E 한국어판 부록: 한국 개발자의 코드 리뷰 이야기 339
E.1 AI와 함께 진화하는 코드 리뷰 문화(김연태) 339
E.2 코드 리뷰가 시스템이 되는 순간(김완섭) 341
E.3 작게 나누고 크게 배우는 코드 리뷰 문화(선용주) 342
E.4 완벽보다 팀을 택하는 코드 리뷰 문화(윤기쁨) 344
E.5 팀과 개인을 모두 성장시키는 코드 리뷰의 태도(임슬기) 345

참고 문헌 348
찾아보기 352