GitHub에 게시된 문서를 지속적으로 번역

오픈 소스와 관련된 관계로 지금까지 다양한 GitHub의 문서를 번역해 왔습니다.

예를 들어, WP-CLI 문서 라든지, WP-API 문서 라든지, 벡터 타일 사양 등등입니다.

대부분의 경우 원본 문서가 그렇게 자주 업데이트되지 않기 때문에 일단 번역하면 확실한 일이 많지만 WP-CLI 문서처럼 자주 업데이트되어 그것을 쫓아야 할 경우가 있습니다.

그런데 이것 상당히 힘들고, 오리지날로 경미한 수정이 있어도, 그 수정 개소를 찾기 위해서 전문을 확인할 필요가 나와 버립니다.

그렇기 때문에 WP-CLI에서는 메인테이너에게 물어 변경할 때마다 태그를 붙이고 추종할 때는 태그 간의 차이를 확인하여 업데이트 위치를 확인하는 워크플로우를 취하고 있습니다.

예: WP-CLI v1.3.0과 v1.4.0 간에 업데이트된 차이
htps : // 기주 b. 이 m/wpcぃ/wpcぃ. 기주 b. 코 m/코 m 파레/v1.3.0. . . v1.4.0

지금까지 뭐 잘 잘 작동하고 있습니다만, 이것을 하기 위해서는 태그를 붙인다고 하는 새로운 워크플로우를 이해해 주지 않으면 안 되므로, 지인이라면 좀처럼 잘 되지 않습니다.

Front-End Checklist라는 문서를 번역했습니다.

며칠 전에 GitHub에서 Front-End Checklist라는 문서가 GitHub에 공개되어 6,000개 이상의 스타를 모으고 있다는 것을 알았습니다.

실제로 내용을 보면 꽤 훌륭한 리스트였으므로 번역해 보았습니다만, 이번은 종래와는 조금 다른 궁리를 해 보았습니다.

원문은 코멘트 아웃 한 후에 남긴다

지금까지 번역할 때는 원래의 원문을 지우고 그 위에 일본어 번역을 쓰고 있었습니다만, 이번에는 아래와 같이 원문을 코멘트 아웃하고 남겨 그 아래의 줄에 일본어 번역 를 추기하는 형태로 했습니다.

<!--
The **Front-End Checklist** is an exhaustive list of all elements you need to have / to test before launching your site / page HTML to production.
-->

**フロントエンドチェックリスト**は、みなさんがウェブサイトや HTML ページを本番環境で公開する前に確認するべきあらゆる項目を網羅したリストです。

<!--
It is based on Front-End developers' years of experience, with the additions coming from some other open-source checklists.
-->

これは、フロントエンド開発者たちの数年に及ぶ経験にもとづいており、さらに他のオープンソースのチェックリストの内容も追加されています。

<!--
## Table of Contents
-->

네, 이것이 성공적이었습니다.

원본 버전의 변경 사항을 병합

이번에 번역한 Frontend Checklist는 상당히 자주 갱신되고 있어 제가 번역하는 동안에도 3회 정도 업데이트가 있었습니다.

이 때 원문이 남아있는 덕분에 Git 명령으로 좋은 느낌으로 차이를 추출할 수 있게 되었습니다.

병합하기 위한 명령의 절차는 다음과 같습니다.

$ git remote add upstream xxxx.git
$ git fetch upstream
$ git merge upstream/master

마지막 명령을 실행하면 충돌이 있다고 합니다만 당황할 필요는 없습니다.

아래는 번역한 문서에 오리지널 측의 차이를 병합한 결과를 Visual Studio Code에서 열린 스크린샷입니다.



이 수정에서는 오리지널판에 새로운 행이 추가된 것 같습니다만, 차분을 보면 그 추가된 행이 예쁘게 번역판의 코멘트 아웃안에 삽입되고 있는 것을 알 수 있습니다.

Visual Studio Code에는 충돌을 해소하는 기능이 있으므로 "Accept Both Changes"라는 버튼을 클릭하면 괜찮습니다.

그리고는, 추가된 원문의 부분을 코멘트 아웃 해 (때로는 이동할 필요가 있는 일도 있다), 그 아래에 번역을 추가해 가는 것으로 종래보다 훨씬 간단하게 번역을 추종시킬 수 있습니다 .