문서화의 가치
어떤 문서들은
- 프로세스의 재사용성을 높인다.
- e.g. 내가 했던 일을 다른 사람도 할 수 있게 한다.
- 커뮤니케이션 비용을 낮춘다.
- 생산성 낭비를 줄일 수 있다.
- e.g. 내가 시간 낭비했던 일을 다른 사람이 다시 하지 않아도 되게 한다.
왜 형식을 갖춘 문서를 만드는가?
첫 번째 이유는, 결정된 사항을 글로 적는 것이 필수불가결하기 때문이다. 오로지 글로 적을 때에만 빠진 곳이 나타나고 모순들이 드러난다. 글로 적는 행위에는 수백 가지의 작은 의사 결정이 필요하며, 분명하고 정확한 정책이 모호한 정책과 구별되는 부분은 이런 의사 결정의 존재 여부에서다.
두 번째 이유는, 결정된 내용을 그 문서를 통해 다른 이들에게 알릴 수 있기 때문이다. 자기가 상식이라 생각했던 정책들을 일부 팀 구성원은 전혀 알지 못한다는 사실에 관리자는 계속 놀라게 될 것이다. 관리자의 기본 업무는 모든 사람이 같은 방향으로 계속 가게 하는 것이다. 따라서 그의 일과는 의사 결정보다는 의사소통이 주가 될 것이며, 이때 그의 문서들은 소통에 따르는 부담을 엄청나게 덜어줄 것이다.
끝으로, 관리자의 문서들은 데이터베이스와 체크리스트 역할을 하기 때문이다. 그 문서들을 주기적으로 검토함으로써 자신의 현 위치를 알며, 방향성을 강조해야 하는지, 수정해야 하는지 알 수 있다.
- 맨먼스 미신, p.111
(개인적으로 “분명하고 정확한 정책이 모호한 정책과 구별되는 부분은 이런 의사 결정의 존재 여부에서다.” 이 부분의 번역이 좀 어색하다고 생각하는데, 대략 “글로 적는 행위에 따르는 수백 가지의 작은 의사 결정을 통해, 분명하고 정확한 정책과 모호한 정책을 구분할 수 있다” 정도의 의도로 쓴 문장이라고 생각한다.)
잘 작성한 글로 의사소통하는 것은 아이디어를 퍼뜨리고 자기 자신을 확장하는 가장 효율적인 방법이므로 글쓰기 기술을 향상시키는 것은 매우 중요합니다.
- 스태프 엔지니어, 스트라이프의 결제 제품 기술 리드 인터뷰 p.218