뒤로
한주연B
한주연B ·

"테크니컬 라이터가 왜 개발자경험을 개선하는 제품을 만드나요?”

지금 저는 테크니컬 라이터로 일하고 있지만, 3년 전에는 개발자로 일하고 있었는데요. 의외로(?) 문서를 읽기 싫어하는 개발자였어요. 문서 경험이 좋지 않았기 때문에 테크니컬 라이터가 된 거기도 해요. 개발자가 제한된 시간에 빠르게 문서를 탐색하고 쉽게 개발할 수 있도록 돕고 싶었거든요.

그런데 문서를 만들다 보니 좋은 개발자경험은 문서만으로 충분하지 않다는 생각을 하게 됐어요. 연동을 막 시작하려는 개발자에게 문서부터 탐색하게 하는 게 좋을까? 혹은 개발 없이 바로 실행해 보는 경험이 더 좋을까? 저는 개발자들이 연동 흐름에 대해 직관적으로 이해할 수 있고, 아무런 설정 없이 바로 브라우저에서 실행할 수 있는 환경을 제공하는 게 좋은 개발자경험이라고 생각하게 됐습니다. 그 과정에서 문서도 읽을 수 있고요.

이런 고민 끝에 토스페이먼츠에서도 그런 경험을 만들어보기로 했어요. 다음 주 개발자경험을 개선할 샌드박스 제품 배포를 앞두고 있는데요. 배포를 앞두고 다른 분들이 생각하는 좋은 개발자경험은 무엇인지도 궁금해지네요. (있다면 댓글로 알려주세요!)

13

댓글

로그인 후 댓글을 남길 수 있습니다.

공다솜
공다솜

테크니컬 라이터가 "그런데 문서를 만들다 보니 좋은 개발자경험은 문서만으로 충분하지 않다는 생각을 하게 됐어요. 연동을 막 시작하려는 개발자에게 문서부터 탐색하게 하는 게 좋을까? 혹은 개발 없이 바로 실행해 보는 경험이 더 좋을까? 저는 개발자들이 연동 흐름에 대해 직관적으로 이해할 수 있고, 아무런 설정 없이 바로 브라우저에서 실행할 수 있는 환경을 제공하는 게 좋은 개발자경험이라고 생각하게 됐습니다. 그 과정에서 문서도 읽을 수 있고요." 이렇게 생각을 확장하기까지 정말 고민이 많으셨을 것 같아요! DX팀 화이팅~

한주연B
한주연B

감사합니다 :)

이요한
이요한

오, 테크니컬 라이터라는 직무가 있는걸 오늘 알았어요! 직무 전환하신 계기도 너무 흥미롭구요! 토스에서 개발 경험을 좋게 하기 위해 노력하시고 있는 부분 너무 궁금해요 ㅎㅎ 짧게 짧게 많이 공유해주세요 (* * )

한주연B
한주연B

감사합니다! 자주 공유드릴게요 ㅎㅎ 다음 주에 제품이 라이브되면 또 소식 전하겠습니다 :)

이정훈
이정훈

오 혹시 KMS를 엮어서 문서 경험 개선한 사례도 있을까요?

한주연B
한주연B

안녕하세요 정훈님! 혹시 내부 지식 관리 시스템 말씀하시는 걸까요?! 토스페이먼츠는 외부 가맹점 개발자들의 결제 연동을 위한 시스템을 만들고 있어서 내부 지식은 일부만 문서화 하고 있어요. 예를 들면 결제 도메인과 개발 관련한 내용을 내부에서 정리하다가 용어사전으로 외부에도 제공하고 있답니다. https://docs.tosspayments.com/common/glossary/index