-
[MDN] MDN HTTP 한글화 문서에 기여하기후기/활동 후기 2024. 5. 7. 21:30반응형
최근 HTTP 버전별 차이에 대해 공부하다가 작년에 자주 들어간 MDN 문서를 통해 학습했었다.
그러다가 문득 문서가 다 한글로 되어 있는지 이것저것 클릭해봤는데, 문서에 생각보다 미번역된 내용들이 있었다. 그래서 내가 공부한 내용중에 아직 번역되지 않은 내용을 기여하면 겸사겸사 더 자세히 학습할 수 있으면서도 영어 공부에도 도움이 되겠다는 생각도 들었다.
기여 가이드는 굉장히 잘 적혀있어서 vscode를 설치해서 yarn start까지 진행했지만, 실제 기여까지는 시간이 꽤 걸렸다. [내가 해석한 내용] → [문서 규칙에 맞게 변경] → [문서 규칙을 검토하면서 어색한 문장 변경] → [주변 지인들에게 번역 스크린샷을 보내 어색한 문장 최종 변경] 과정이 이어졌다. 처음이라 시간이 걸렸는데, 확실히 첫 기여에서 꼼꼼히 진행하니까 두번째 기여부터는 속도가 붙었다.
내가 기여한 페이지는 set-cookie / user-agent / location 헤더로 내가 알고 있는 헤더만 번역을 진행했다. 미번역된 헤더도 좀 있었지만, 생전 처음 보는 헤더를 번역해서 기여하는건 나에게 실질적인 도움이 될 것 같지는 않아보였다. 그래서 좀 더 기여하고 싶었지만, 내가 알만한 내용들은 번역되어 있어서 나중에 다른 기회가 생기면 다시 해보기로 했다.
문장 번역하는건 생략하고, 기여에 관심 있는 분들이 볼만한 내용인 번역 후 과정이다.
https://github.com/mdn/translated-content/issues/827
일단 여기 글에 설정된 링크를 모두 클릭해보면 다 도움을 받을 수 있다. 구글링으로 찾는 것은 과거 기여 가이드라인과 최근 기여 가이드라인 링크가 섞여 있기 때문에 위 링크 기반으로 찾는게 좋다.
내가 자주 봤던 링크는 아래이다. 여기중에서 용어 안내서를 제일 많이 봤었다.
- 최신 가이드라인 : https://github.com/mdn/translated-content/blob/main/docs/ko/README.md
- 번역 안내서 : https://github.com/mdn/translated-content/blob/main/docs/ko/guides/translation-guide.md
- 용어 안내서 : https://github.com/mdn/translated-content/blob/main/docs/ko/guides/glossary-guide.md
- macro 안내서 : https://github.com/mdn/translated-content/blob/main/docs/ko/guides/macro-guide.md
세세한 규칙의 경우에는 mdn-linter가 PR이 업데이트 될 때마다 돌아가서 반영만 해주면 된다.
그리고 merge가 되기 전에 한국 운영진 분들이 코드 리뷰를 해주시고, merge하기 때문에 이상하게 번역된 것에 대해 크게 염려를 안가져도 된다. 오픈소스 기여가 누군가가 코드 리뷰를 해줘서 피드백을 받을 수 있다는게 정말 큰 장점인 것 같다.
개발자 문서는 대부분 쉬운 영어를 추구하기 때문에 번역하는데 엄청 큰 어려움은 없었다. 하지만 가끔가다 하나씩 긴 문장이 있는 경우도 있어서 주변 지인들과 AI 도움을 받았었다. 특히 번역하면서 다시 한 번 느낀게 AI 번역이 아직까지는 완벽하지 않다는 점이다. 해석하기 난해한 문장이 있어서 번역기를 돌렸는데 DeepL, ChatGPT, Papago, 구글 번역 모두 번역 결과가 다른 문장도 있어서 고생 했던 문장도 있다.
나는 영어를 못해서 문서 번역은 '나중에', '언젠가'라는 생각만 가지고 있었는데, 이번 기회에 도전해보니까 '내 생각보다는 어렵지 않구나'라는 생각이 절로 들었다. 뭐든 처음엔 어렵게 보여도 일단 도전해보면 생각보다 할만한 것 같다.
그리고 이 글을 쓰려고 오랜만에 PR에 들어갔는데 이전엔 없었던 폭죽 이모지가 3개나 있어서 순간 내가 뭘 잘못했나하고 얼어붙었다 ㅋㅋㅋ.... 다들 감사합니다
반응형'후기 > 활동 후기' 카테고리의 다른 글
[후기] 소프트웨어 마에스트로 15기 최종 합격 후기 (22) 2024.03.25 제3회 한국항공대 프로그래밍 경진대회 (KAUPC) 후기 (2) 2023.08.05 2022 오픈소스 컨트리뷰션 아카데미 후기 (2) 2022.12.20 국가우수장학금(이공계) 일시지원 선발 후기 (8) 2022.12.19 한국항공대 소프트웨어학과 학술제 월드소프트콘 개최 후기 (2) 2022.12.11