2. Beyond Our Expertise
한주연 토스 · 토스 기술 블로그
AI 핵심 요약
토스의 기술 문서는 비개발자가 수정하기 어려운 SSG 기반 문서, 오래되고 출처가 불분명한 기록, 여러 도구와 대화에 흩어진 지식 때문에 작성과 활용, 유지 관리에 어려움을 겪었다. 기술 문서 작성자(TW)들은 누구나 쉽게 쓰고 AI와 연동할 수 있으며 조직 지식을 한곳에 모으는 내부 문서 플랫폼 todoc을 만들고, 팀별 공간과 API·CLI·MCP 접근을 제공했다. 문서 품질 기준과 AI 편집·초안 생성 기능을 제품에 반영했으며, 업무 중 생기는 결정·대화·코드로 문서를 만들고 변경 사항을 추적해 최신성을 유지하는 시스템도 설계하고 있다. 핵심은 TW의 문서 작성 전문성을 시스템에 내장해, 사람이 계속 관리하지 않아도 신뢰할 수 있는 지식이 쌓이고 갱신되도록 하는 것이다.
- 문서 작성 과정의 마찰을 줄이려면 개발자 중심의 저장소·리뷰 절차가 비개발자에게도 적합한지 살펴야 합니다.
- 문서가 많아질수록 작성 편의성뿐 아니라 작성자·시점·목적, 최신성 같은 신뢰 기준도 함께 관리해야 합니다.
- 조직 지식을 AI에 활용하려면 API, CLI, MCP 등으로 접근할 수 있게 하고 여러 출처의 정보를 연결해야 합니다.
- 전문가의 판단 기준을 제품에 내장하면 문서 검토와 품질 관리를 개인의 수작업에서 시스템의 역할로 옮길 수 있습니다.
소개
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.
비슷한 학습 자료
문서 한주연
The Toss Frontend team no longer has to dig through documents to find what they need. We’re building an environment where developers can get immediate answers to their questions through docs and AI. Here’s how we built a new documentation system that lets developers focus entirely on development.
프론트엔드 AI에이전트 개발
문서 김혜빈D
5. Technical Writer, 사라질 결심
문서 한주연
2. 전문성 밖으로 나아가기
문서 한주연
1. 세상에 없던 직무를 만들어가기
문서 이지윤