Next.js KR 문서 오픈소스 컨트리뷰션 후기

Next.js 공식 문서 한글화 작업에 기여한 후기이다.

---

Vercel Github Discussion : https://github.com/vercel/next.js/discussions/51566
Nextjs.kr Github : https://github.com/Nextjs-kr/Nextjs.kr

---

서론

Next.js 한국 문서 번역 컨트리뷰터를 모집한다는 소식을 듣고, 경험해 보고 싶어 작업을 진행하였다.

이전에는 MDN 한국 문서에서 오타를 발견했을 때 (한 줄 분량의) PR을 보냈던 경험만이 있었다.
한 페이지 전체를 번역하는 경험은 처음이라 기대가 되기도 했고 누군가에게 도움을 줄 거라는 생각에 뿌듯한 마음으로 작업하였다.

https://github.com/Nextjs-kr/Nextjs.kr/pull/225
두괄식으로 결과물부터 보여주자면,
위 PR과 같이 내 레포지토리로 포크하여 번역 작업한 후, upstream으로 PR을 보낸 후 검수를 요청드리고 반영하였다.
이슈 제작, assign, 머지 등은 모두 Next.js 문서 번역을 시작하신 ChanghyeonYoon님께서 진행해 주셨다.

본론

모든 기여 절차는 위 레포지토리의 1번 이슈에 상세히 적혀 있다.

1. 작업할 파일 comment 남기기

다른 분들께서 assign되지 않고, comment에서 아직 이야기 되지 않은 문서 중 작업하고 싶은 문서를 이슈의 comment로 남기면, 확인 후 Assign해주신다.

동일 이름의 파일이 존재하기 때문에 코멘트를 작성할 때에는 문서가 있는 위치를 명시하여 작성해야 좋다. 나의 경우 아래와 같이 코멘트를 남겼다.

안녕하세요, 좋은 기회 열어주셔서 감사합니다.
아래 파트 번역 신청합니다!

02-app >> 02-api-reference >> 05-next-config-js >> httpAgentOptions.mdx

2. fork

깃허브 공식 문서에 fork란 무엇인지, 어떻게 하는지, 왜 오픈 소스 프로젝트에서 branching 대신 fork를 사용하는지 작성되어 있어서 첨부된 링크로 설명을 대신한다. ("끌어오기 요청"이라고 번역된 부분은 "Pull Request"이다..)

3. 번역 작업, PR 보내기

번역 작업의 경우, 가이드에 명시해 주신 단어 사전과 Best Practice를 참조하여 진행하였다. PR 템플릿에 PR을 open하기 직전에 빠뜨린 부분이 없는지 체크하는 부분이 포함되어 있어서 좋았다.

결론

나는 한 발 늦게 참여했기 때문에 재밌어 보이는 문서들은 다 다른 개발자분들께서 찜꽁하셨기에, 나는 조금 아쉽게 변두리에 있는 짧은 문서를 진행하게 되었다.

아쉬움과는 반대로, 짧은 글을 번역했는데도 고려해야 할 것이 많았기에 많이 배웠다. 공식 문서 번역 작업 중 어떤 부분을 각자 고민하고, 어떤 부분을 공통된 약속으로 가져가는지 그 과정을 뜯어볼 수 있어서 좋았다.

특히 Chat GPT의 등장으로 요즘 개발 문서를 내 눈으로 읽거나 읽으며 깊게 생각해 본 적이 (체감상) 20% 정도로 줄었는데, 번역 작업을 내 인간 지능으로 진행해서 더 뜻깊은 작업이었다.