메뉴 바로가기 검색 및 카테고리 바로가기

한빛미디어

독자리뷰

와닿는 한 표현 : \'문서도 제품이다\'

soulfeve***

|

2023-05-28

Docs for Developers 기술 문서 작성 완벽 가이드

소프트웨어 개발자를 안내하는 테크니컬 라이팅을 위한 실무 노트 우아한형제들, 카카오, AWS, LINE Plus, 쿠팡, NHN, 데브시스터즈, 넷마블 등 국내 테크니컬 라이터 11인 인터뷰 특별 수록!

  • 저자 : 자레드 바티 , 재커리 사라 콜라이센 , 젠 램본 , 데이비드 누네즈 , 하이디 워터하우스
  • 번역 : 하성창
  • 출간 : 2023-04-10

 

 

 

개발 처음 배울 때는 코딩만 잘하면 되는 줄 알았다 (그 조차도 못함)

 

개발자는 은둔하고 소심한 체크남방 남자의 삶일 줄 알았으나

의외로 정말 많은 발표, 문서화를 경험하게 됐다.

 

개발자끼리는 API 명세서를 포함한 각종 문서를 만들어야했다.

최근엔 소마를 하게 되면서 기획서를 만들고, 발표 준비를 했다.

내 생각을 전달하는 방법이 몹시 중요하다.

 

무슨 문서든 똑같다.

기획서를 작성하라고 시킴 당하고(?) API 명세서를 만들라고 강요당하면 벙찐다.

 

피드백을 받을 때 꽤나 많이 들어봤고, 나도 많이 고민하는 것은

 

우리는 오랫동안 고민하면서 익숙해졌지만

듣는 사람들은 이 내용이 뭘 말하는 지 모른다는 사실이다.

이 책에서는 “지식의 저주”라는 표현을 쓴다. 정말 적합한 말이 아닐까?

 

독자가 고급 개발자라면? 초급 개발자라면? 일반인이라면? 이런 고민을 하고

고민을 넘어서 감정을 이입해야한다.

디자인씽킹도 그렇고, 기획에 대해서도 고민하는 것도 그렇고 이런 문서화를 할 때에도

결국에는 감정이입이 중요하다.

 

후반에는 국내 테크니컬 라이팅을 하는 분들의 인터뷰가 나온다.

굉장히 딱 와닿는 표현을 봤다.

문서도 ‘제품’이다.

개발이든 제품이든 만들면서 파생되는 부수적인 작성물이 아니구나 라고 느꼈다.

 

의외로 많은 생각을 하게 짧은 책이었다고 생각한다. 좋았다.

닫기

해당 상품을 장바구니에 담았습니다.이미 장바구니에 추가된 상품입니다.
장바구니로 이동하시겠습니까?