Next.js Docs 한글화 작업 참여하기

2023년 8월 3일

서론

처음 개발 공부를 시작했을때부터, 오픈소스 도움을 많이 받았다. 나도 오픈소스에 기여하고 싶다는 생각을 항상 품고 있었는데 next.js 한글 문서 번역에 참여하였다!

번역을 하며 Next.js에 대한 이해도를 높이고 많은 사람들에게 지식을 공유할 수 있는 좋은 경험이었다.

Nextjs.kr Github : https://github.com/Nextjs-kr/Nextjs.kr

총 2개의 번역에 참여하였다.

  1. custom-error 번역 : pr
    Next.js에서 에러페이지를 생성하는데 제공하는 기본 템플릿과 이를 활용한 커스텀 페이지를 생성하는 방법에 대해 서술하고 있다.
  2. app index.mdx 번역 : pr
    레이아웃, 서버 컴포넌트, 서스펜스 등을 포함한 Next.js와 React의 최신 기능인 app-router에 대해 간략하게 소개하고 있다.

오픈소스 기여 방법

번역 작업에 참여한 과정은 다음과 같다.

  1. Issues 탭에서 원하는 단원을 신청하고 할당을 받는다.
  2. repository를 fork하여 기여 가이드에 맞추어 번역을 진행한다.
  3. upstream repository에 pr을 날린다.
  4. 리뷰에 따라 수정 사항을 반영한다.
  5. 검토가 완료되면 리뷰어분들이 머지를 해주신다.

후기

용어, 문맥을 고려하며 번역을 진행하며 전체적인 next의 특징을 이해할 수 있었다. 컨트리뷰터로서 지켜야할 오픈소스의 규칙들도 경험해 볼 수 있었고, 표준화된 문서를 만들기 위한 번역팀의 노력을 엿볼 수 있었다.

리뷰어 분들께서 꼼꼼하게 pr를 봐주셔서 놓쳤던 부분도 발견하고 더 나은 문장으로 다듬어갔다. 공식 문서의 중요성을 다시 한번 체감하면서, next.js 한글 문서 번역을 통해 오픈소스와 더욱 가까워진 기분이다!