문서
2. Beyond Our Expertise
한주연 · 토스 · 토스 기술 블로그
소개
This is the story of how we turned Technical Writers’ challenges and expertise into a product called "todoc", and how the process helped us take that expertise even further.
AI 핵심 요약
토스의 기술 문서는 비개발자가 수정하기 어려운 SSG 기반 문서, 오래되고 출처가 불분명한 기록, 여러 도구와 대화에 흩어진 지식 때문에 작성과 활용, 유지 관리에 어려움을 겪었다. 기술 문서 작성자(TW)들은 누구나 쉽게 쓰고 AI와 연동할 수 있으며 조직 지식을 한곳에 모으는 내부 문서 플랫폼 todoc을 만들고, 팀별 공간과 API·CLI·MCP 접근을 제공했다. 문서 품질 기준과 AI 편집·초안 생성 기능을 제품에 반영했으며, 업무 중 생기는 결정·대화·코드로 문서를 만들고 변경 사항을 추적해 최신성을 유지하는 시스템도 설계하고 있다. 핵심은 TW의 문서 작성 전문성을 시스템에 내장해, 사람이 계속 관리하지 않아도 신뢰할 수 있는 지식이 쌓이고 갱신되도록 하는 것이다.
- 문서 작성 과정의 마찰을 줄이려면 개발자 중심의 저장소·리뷰 절차가 비개발자에게도 적합한지 살펴야 합니다.
- 문서가 많아질수록 작성 편의성뿐 아니라 작성자·시점·목적, 최신성 같은 신뢰 기준도 함께 관리해야 합니다.
- 조직 지식을 AI에 활용하려면 API, CLI, MCP 등으로 접근할 수 있게 하고 여러 출처의 정보를 연결해야 합니다.
- 전문가의 판단 기준을 제품에 내장하면 문서 검토와 품질 관리를 개인의 수작업에서 시스템의 역할로 옮길 수 있습니다.
