일단 읽어 볼 만한 '코드 밖 커뮤니케이션'

코드 밖 커뮤니케이션
팀원 온보딩부터 UML 활용법, 글쓰기 스킬, 원격 근무 노하우까지
저자: 재퀴 리드 / 번역: 곽지원 / 한빛미디어 / 2024-08-30
https://www.hanbit.co.kr/store/books/look.php?p_code=B1493233905

 

저자는 하고픈 말이 정말 많았나 봅니다. 팀원 온보딩부터 UML 활용법, 글쓰기 스킬, 원격 근무 노하우까지 348쪽에 담기는 정말 힘든 일입니다. 1부에서 4부까지 각 부에 다루는 주제가 꽤나 상이합니다. 저자는 1부에서 다이어그램을 주요 소재로 전체 분량의 1/3에 해당하는 분량을 할애합니다. 1부 2장까지 읽다가 책을 덮을 독자가 꽤 나오지 않을까 우려스럽습니다. 아예 2부부터 읽어도 좋겠습니다.

 

저자가 왜 이렇게 했는지는 짐작이 갑니다. 그냥 착실하게 개발만 하면 되는 역할에서 성장하여 승진하거나 봉급이 오르면, '기술력 떨어져 보이니까 오픈소스 썼다는 걸 언급하지 말라'라고 하는 사람들까지 IT 관련 의사결정에 들어오는 난장판에 들어오게 됩니다. 이 아수라장에서 어떻게든 상황과 상태를 이해하게 하려면 그림을 잘 그리는 수밖에 없습니다. 저자는 그림조차 '읽기' 꺼리는 이해관계자에게 최선을 다하는 방법을 세세하게 설명합니다. 때문에 색약을 다루는 내용이 거슬릴 정도로 장애감수성이 낮더라도 1부는 꼭 참고할 만합니다. 정말 별 사람이 다 들어오는 의사결정의 장에서 협업에 나설 때에 갖출 기본적인 자세에 대해 깨달을 수 있겠습니다.

 

나머지 2부에서 4부까지도 확실히 IT 개발 업무 종사자에게 유용한 내용입니다. 다만 소프트 스킬(soft skill) 관련 조언으로서 깊게 이야기하다 금세 넓게 이야기하는 스타일이 좀 생소했습니다. 축약어를 쓸 때, 바디랭귀지 할 때, 문화차이가 있을 때, 에토스/파토스/로고스, 피드백을 받을 때, ADR(Architecture Decision Record, 아키텍처 결정 레코드) 권장, 회의할 때 요령, 협업/소통 도구 장단점같은 이야기가 이어집니다. 다 읽고 나서 다시 훑어 보면서 유용하지 않은 주제가 없음을 확인했습니다. 전 제가 해오던 플랫폼 일이 있어서 저자가 ADR을 특별히 좀 더 언급한 게 참 마음에 들었습니다.

 

최근 회사 생활 가이드류 책에서는 팩스(fax, Facsimile) 예절이 나오지 않듯이 이 책에 나온 세세한 조언 상당수가 15년쯤 후에는 꽤 바뀌게 될지도 모르겠습니다. 그래도 지금은 도움이 될 조언이 많은 책입니다.

 

"한빛미디어 <나는리뷰어다> 활동을 위해서 책을 제공받아 작성된 서평입니다."

---

반응형

[1부 | 시각적 커뮤니케이션]

1장 커뮤니케이션의 핵심
_독자 이해하기
_추상화 레벨 혼합
_표현의 일관성
_요약

 

2장 난잡함 정리하기
-색의 과부하
_상자 속 상자 속 상자
_관계 거미줄
_텍스트 균형 잡기
_요약

 

3장 접근성
_색상에 의존한 커뮤니케이션
_범례를 추가하자
_레이블 적절히 사용하기
_요약

 

4장 내러티브
_큰 그림이 먼저다
_다이어그램 흐름을 기대에 맞추자
_명확한 관계
_요약

 

5장 표기법
_아이콘으로 의미 전달하기
_특별한 이유 없이 UML 사용하기
_동작과 구조 뒤섞기
_예상에 어긋나기
_요약

 

6장 문장의 구성
_가독성이 떨어지는 다이어그램
_스타일 커뮤니케이션
_불분명한 문장 구성
_시각적 균형 만들기
_요약

 

[2부 | 멀티모달 커뮤니케이션]
 

7장 서면 커뮤니케이션
_단순한 언어
_축약어 지옥
_구조화하기
_기술 문서 작성 구문
_요약

 

8장 언어적 및 비언어적 커뮤니케이션
_메시지 인코딩하기
_메시지 디코딩하기
_영향력과 설득
_요약

 

9장 수사학 3요소
_에토스
_파토스
_로고스
_요약

[3부 | 지식 전달하기]
 

10장 지식 관리의 원칙
_프로젝트보다 프로덕트
_텍스트보다 추상화
_관점 중심 문서화
_요약

 

11장 지식과 사람
_피드백은 일찍, 자주 받자
_짐을 나누기
_JIT 아키텍처
_요약

 

12장 모범 사례
_아키텍처 결정 레코드
_아키텍처 특성
_모든 문서를 코드처럼
_요약

[4부 | 원격으로 소통하기]
 

13장 원격 시간
_시간 동기화하기
_근무 패턴 존중하기
_에너지 및 생산성 향상
요약

 

14장 원격 근무의 원칙
_동기식 회의
_비동기식 사고
_원격 우선
_요약

 

15장 원격 채널
_대칭 이메일
_온라인 발표
_원격 도구와 거버넌스
_요약

 

[부록]
ADR 템플릿