그 많은 개발 문서는 누가 다 만들었을까 (2) 개발자의 학습을 돕는 모든 것

토스페이먼츠는 개발자센터에 들어온 개발자의 첫 경험을 개선하기 위해 테크니컬 라이터의 역할을 문서 작성에서 개발자 학습 전반으로 확장하고 DX 팀을 만들었다. 사용성 테스트와 인터뷰를 통해 문서를 꼼꼼히 읽는 개발자뿐 아니라 코드부터 확인하는 개발자도 고려해야 한다고 판단했다. 이에 브라우저에서 바로 코드를 실행하는 샌드박스와 설명·예제 코드·미리보기가 연동되는 인터랙티브 튜토리얼을 만들었다. 샌드박스 도입 후 로그인 사용자의 결제 요청량과 튜토리얼 유입이 늘었고, 튜토리얼 사용 및 스크롤 지표도 개선되어 개발자 경험은 읽기 좋은 문서를 넘어 직접 실행하고 결과를 확인하는 학습 환경까지 포함한다는 점을 보여줬다.

• 개발자 경험은 문서뿐 아니라 API·SDK·도구를 처음 접하고 학습하는 전체 여정으로 설계할 수 있다.
• 사용성 테스트와 인터뷰로 개발자의 학습 방식을 파악하고, 문서를 먼저 읽는 사람과 코드부터 보는 사람을 함께 고려한다.
• 브라우저 기반 샌드박스는 로컬 환경 설정과 저장소 복제 없이 코드를 실행해 제품을 체험하게 한다.
• 튜토리얼에서 설명, 예제 코드, 미리보기를 연결하면 구현 결과와 전체 흐름을 더 쉽게 이해할 수 있다.