본문으로 이동
문서

2. 전문성 밖으로 나아가기

한주연 · 토스 · 토스 기술 블로그

원본 보기

소개

Technical Writer의 고민과 전문성을 '토독'이라는 제품으로 만들면서, 기존의 전문성을 더 확장하는 과정을 담았습니다.

AI 핵심 요약

기존 사내 문서는 SSG 기반 작성 과정이 비개발자에게 어렵고, 낡거나 미완성인 내용과 여러 도구에 흩어진 지식 때문에 신뢰성과 활용성이 낮았습니다. 이를 해결하기 위해 Technical Writer의 문서 전문성을 제품으로 확장한 사내 플랫폼 토독을 만들고, 누구나 쉽게 작성하며 여러 지식 소스를 모아 AI와 API·CLI·MCP로 활용할 수 있도록 했습니다. 문서 품질을 유지하기 위해 좋은 문서의 기준을 AI 교정과 자동 리뷰에 반영하고, 메신저 논의와 코드 변경에서 문서를 생성·갱신하는 방향도 추진하고 있습니다. 글은 TW의 역할이 직접 문서를 잘 쓰는 데서 나아가, 신뢰할 수 있는 지식이 업무 과정에서 반복적으로 만들어지고 유지되도록 시스템과 거버넌스를 설계하는 일로 확장된다고 설명합니다.

  • 문서 작성 도구는 개발자뿐 아니라 디자이너와 PM도 바로 쓸 수 있도록 진입 장벽을 낮춰야 합니다.
  • 문서를 한곳에 모으는 것만으로는 부족하며, 최신성·유효성·실제 사용 여부를 판별하는 관리 체계가 필요합니다.
  • 좋은 문서의 기준을 명시하면 AI 교정과 자동 리뷰, 초안 생성에 활용할 수 있습니다.
  • 사람이 따로 문서를 작성하기를 기다리기보다 메신저 논의와 코드 변경 등 업무 흔적에서 지식을 자동으로 만들고 갱신하는 방식을 고려할 수 있습니다.