번역 기여 가이드 - Gunforge/learn-go-with-tests-ko GitHub Wiki

이 번역 가이드는 논의를 거쳐 수정될 수 있습니다.

번역 문체

https://github.com/Gunforge/learn-go-with-tests-ko/issues/3 에서 논의된 바와 같이, 기본적으로 하십시오체를 사용하며 해요체를 혼용합니다. 객관적인 기준은 없으나 명령문과 의문문처럼 하십시오체에서 딱딱하게 느껴지는 부분은 해요체를 사용합니다. 이것 이외에 정해진 편집 가이드는 없습니다.

번역을 위해 마크다운 파일을 수정할 때

  • 원문을 삭제하지 말고 HTML 문법으로 주석 처리하세요.
  • 교열 시 원문과 비교하기 쉽도록 문단마다 주석 처리된 원문과 번역본을 함께 두세요.

브랜치 전략

  • 마스터 브랜치는 master-ko입니다.
  • 번역 교열 브랜치는 trans/*입니다.
  • 번역 초안 브랜치는 drafts입니다.

작업 흐름

모든 작업은 파일 단위로 이루어집니다. hello.md를 번역한다고 가정합시다.

초안 작성

  • master-ko 브랜치를 베이스로 draft/hello 브랜치를 만들어 초안을 작업합니다.
  • 초안은 1인이 작업합니다. draft/hello에서 브랜치를 만들 필요는 없으며 직접 커밋합니다.
  • 초안은 언제나 drafts로 푸시될 수 있습니다.
  • draft/hellotrans/hello에 병합하는 PR을 제출합니다.

교열

  • 교열은 여러 사람이 할 수 있습니다.
  • trans/hello를 베이스로 임의의 브랜치를 만들어 작업합니다.
  • 다시 trans/hello에 병합하는 PR을 제출합니다.

출판

  • trans/hello 브랜치를 master-ko에 병합하는 PR을 제출합니다.