https://product.kyobobook.co.kr/detail/S000201419245
Docs for Developers 기술 문서 작성 완벽 가이드 | 자레드 바티 - 교보문고
Docs for Developers 기술 문서 작성 완벽 가이드 | 소프트웨어 개발자를 안내하는 테크니컬 라이팅을 위한 실무 노트우아한형제들, 카카오, AWS, LINE Plus, 쿠팡, NHN, 데브시스터즈, 넷마블 등 국내 테크
product.kyobobook.co.kr
개발자, 한 달에 책 한 권 읽기 2023년 5월 모임 | Festa!
Festa에서 당신이 찾는 이벤트를 만나보세요.
festa.io
2023년 05월 25일 책 모임 - Docs for Developers
개발자 입장에서 문서를 작성할 때, 어떤 것들을 고려해야할지에 관한 책이다. 개발 관련 문서에 무슨 내용들이 들어가야할지를 잘 설명해준다.
지식의 저주(사람들이 다른 사람도 같은 지식을 갖고 있다고 가정)로 책이 시작한다.
기획에서 Persona를 고민하고 기획을 하는 것처럼 문서도 어떤 대상이 무엇이 필요한지
고려한다는 점이 흥미롭다.사용자 목표를 비즈니스 관점에서 먼저 정의하는 것이 중요하다.
주요 키워드
- 문서 작성할 때 주변의 도움을 구하고, 피드백을 구하라
책모임에서 토론한 내용
- 기술블로그의 목적?
채용이 목적. 우리는 개발자들이 고민하는 문제를 어떻게 풀었다.
재미있게 쓰기. 흥미를 갖은 사람은 와라. 주제에 공감하는 사람은 와라.
기술블로그에서 재미있는 사진이나 흥미롭게 글을 쓰는 것도 다 이유가 있다.
너 내 동료가 되라
- 피드백의 중요성
https://trivium21c.com/2017/07/29/the-problem-with-austins-butterfly/comment-page-1/
The Problem With Austin’s Butterfly
Ron Berger’s famous ‘Austin’s Butterfly’ is a great lesson about how redrafting and feedback can help a child create a more accurate ‘scientific’ drawing …
trivium21c.com
Austin의 나비. 어린이는 같은 반에 있는 다른 학생들의 피드백을 통해 좀 더 나비의 모습을 그릴 수 있게 되었다.
전문가가 아닌 주변의 피드백도 유효할 수 있다.
'읽은책' 카테고리의 다른 글
| 2029 기계가 멈추는 날 (1) | 2023.06.17 |
|---|---|
| 웹 개발자를 위한 자바스크립트의 모든 것 (1) | 2023.06.07 |
| 프로그래머의 길, 멘토에게 묻다 (0) | 2023.05.13 |
| 자바 관련 최근에 읽은 책 (0) | 2023.05.13 |
| 자바 성능 튜닝 이야기 (0) | 2023.05.13 |
