개발자와 글쓰기의 세 가지 장벽
핵심 아이디어
개발자들이 코드는 잘 작성하면서도 문서 작성에 어려움을 겪는 주요 원인은 ‘귀찮다, 어렵다, 바쁘다’라는 세 가지 심리적 장벽에 있다.
요약
귀찮음은 프로그래밍 언어의 축약적 특성과 문어체 글쓰기 사이의 간극에서 발생하고, 어려움은 문서 구조화와 시작점 설정의 부담에서 기인하며, 바쁨은 실제 시간 부족보다는 우선순위 문제에 가깝다. 이런 장벽을 극복하기 위해서는 작은 성취부터 시작하기, 다른 잘 작성된 문서 분석하기, 목차 작성으로 구조 익히기 등의 실천적 방법이 효과적이다.
견해
결국 테크니컬 라이팅도 다른 개발 역량과 마찬가지로 반복적인 연습과 피드백을 통해 향상되는 기술이며, 글쓰기를 필수 산출물로 인식하는 문화적 변화가 필요하다.