"무엇보다 개발자 경험(DX, Developer eXperience)에 관심이 있고, 이 경험에 문서가 기여한다는 강력한 믿음이 있는 분이면 좋겠어요."
오늘은 토스페이먼츠 Technical Writer 한주연님의 이야기를 들려드려요.
Q. 토스페이먼츠의 Technical Writer는 어떤 일을 하나요?
토스페이먼츠는 결제 연동에 필요한 *API와 *SDK, 간편 결제 등 다양한 제품을 제공하고 있어요.
Technical Writer는 토스페이먼츠의 제품을 개발자들이 더욱 편하게 연동할 수 있도록 문서를 작성하고 배포합니다. 이 문서를 우리는 ‘기술 문서’라고 불러요.
Technical Writer의 가장 중요한 역할은 기술 문서에 대한 Ownership을 가진다는 점이에요. 기술문서를 읽고 연동 작업을 하는 가맹점의 개발자에게 최고의 경험을 전달합니다. 토스페이먼츠는 B2B 서비스를 제공하는 회사이기 때문에 기술 제품(API, SDK)의 연동 경험이 매우 중요해요.
•
API(Application Programming Interface, 애플리케이션 프로그램 인터페이스): 소프트웨어 인터페이스로 다른 종류의 소프트웨어에 서비스를 제공합니다.
•
SDK(Software Development Kit, 소프트웨어 개발 키트): 특정 목적을 위한 개발 도구 모음입니다.
Q. 함께하고 있는 팀과 협업 방법에 대해 소개해주세요.
제가 속한 팀은 토스페이먼츠에서 만드는 API의 품질을 수호하는 것이 목표에요. 이를 달성하기 위해, 공개 API의 기준을 세우고 문서화하는 일을 합니다. 현재, 테크니컬 라이터인 저를 포함해 팀 리더와 서버 개발자, 프론트엔드 개발자로 구성되어 있어요.
또 팀원분들 외에도 API를 리뷰하는 과정에서 각 테크 조직과 사일로 분들과 많은 협업을 하게 됩니다. 예를 들어 특정 팀이나 사일로에서 가맹점에 새로운 기능을 API로 제공하려고 할 때 저희 팀에서 함께 API 스펙을 리뷰하고 피드백하는 과정을 거칩니다. Technical Writer도 이 과정에 참여해 팀원들과 함께 더 나은 API 문서를 제공하게 됩니다.
API외에도 브랜드페이와 같은 토스페이먼츠의 다양한 제품들의 기술 문서도 담당하여 작성하고 있습니다.
Q. 어떤 분이 토스페이먼츠의 Technical Writer와 잘 맞을까요?
개발자 입장에서 올바르고 일관된 정보를 제공 할 수 있는 분, 필요한 정보를 찾기 좋은 구조에 대해 끊임없이 고민하는 분, 기술 문서를 제품으로 바라보고 개선해나가는 분이면 좋겠습니다.
무엇보다 개발자 경험(DX, Developer eXperience)에 관심이 있고, 이 경험에 문서가 기여한다는 강력한 믿음이 있는 분이면 좋겠어요.
이 믿음을 기반으로 단순히 개발자로부터 받은 초안을 옮기는 정도로 역할을 한정하지 않고 기술문서를 제품으로 함께 이끌어나갈 분을 기다립니다.