그 많은 개발 문서는 누가 다 만들었을까 (1) 토스페이먼츠 테크니컬 라이터가 하는 일

토스페이먼츠의 테크니컬 라이터는 개발자가 제품과 기술을 빠르게 익히고 적용하도록 돕기 위해 문서 작성뿐 아니라 테스트, API 리뷰, DevRel, 용어 정리까지 맡는다. 문서의 정보 구조와 튜토리얼·가이드를 만들고 예제 코드를 직접 확인하며, 개발자 피드백과 반복 문의를 바탕으로 문서와 제품 개선을 이어간다. API 설계 단계에도 참여해 설명하기 어려운 스펙을 코드 스멜로 보고 의견을 내며, 기술 콘텐츠와 팀 공통 용어 정리로 개발자 및 내부 구성원과의 소통을 돕는다. 이 역할에는 새로운 기술을 능동적으로 학습하고 문제 해결의 맥락을 글로 구성하는 능력, 문서를 넘어 개발자 경험 전체를 설계하려는 관점이 필요하다.

• 문서의 정보 구조를 설계하고 튜토리얼·가이드·예제 코드를 직접 검증하면 개발자가 실제로 따라 할 수 있는 자료를 만들 수 있다.
• 반복되는 문서 문의는 설명을 보강하는 데 그치지 말고 제품 자체의 사용성 문제인지 살펴 제품 팀에 전달한다.
• API 리뷰에 테크니컬 라이터가 참여하면 설명하기 어려운 스펙을 설계 단계에서 발견하고 개선할 수 있다.
• 기술 문서는 해결하려는 문제와 해결 과정을 연결해 구성하면 학습자가 맥락을 이해하기 쉽다.
• 테크니컬 라이터에게는 기존 기술 지식뿐 아니라 새 기술을 능동적으로 배우고 개발자의 학습 여정을 설계하는 역량이 중요하다.