1. 저장소를 포크(fork)합니다.

2. 가장 높은 버전의 브랜치로 Codespaces 를 만듭니다.

3. 작업할 이슈를 선택합니다.

4.`.po` 파일을 번역하고,`pdk watch` 명령으로 결과를 확인합니다.

5.`pdk format` 으로 파일을 표준형식으로 변환한 후 커밋합니다.

6. PR 을 보낸 후에 리뷰어와 협의하여 최종 병합될 때까지 수정합니다.

4.`.po` 파일을 번역하고,`pdk watch` 명령으로 결과를 확인합니다. 번역 대상은`fuzzy` 가 붙어있거나`msgstr` 이 빈문자열인 것입니다.

5.`Last-Translator` 를 본인으로 변경한 후,`pdk build` 가 에러나 경고를 주지는 않는지 확인해 주십시오.

6.`pdk format` 으로 파일을 표준형식으로 변환한 후 커밋합니다. 이 때`sphinx-lint` 검사가 수행됩니다.

보통`No problems found.` 라는 메시지가 출력됩니다. 경고가 있다면 모두 제거해 주십시오.

7. PR 을 보낸 후에 리뷰어와 협의하여 최종 병합될 때까지 수정합니다. 현재의 리뷰 정책은 "개선되었는가?" 입니다. 따라서 새 번역의 경우 장벽이 높지 않습니다.

일감은 이슈에서 고르시면 됩니다.

모든`.po` 파일을 개별 이슈로 등록해 두었습니다.

이슈의 순서는 중요하지 않습니다.

서로 일이 겹치지 않도록, 시작하실 때 이슈에 코멘트를 남겨주시면 좋습니다.

아주 오래된 코멘트는 무시하시고 작업하셔도 됩니다.

기존의 번역을 개선하는 작업이라면 이슈에 연연하지 말고 PR 을 보내시면됩니다.

다만 상세한 설명을 함께 주셔야 하고, 가능하면 작은 덩어리로 PR 을 보내주시기 바랍니다.

이 때 다음과 같은 사항을 유의하셔야 합니다.

- 최신 버전의 브랜치에서 작업하세요.

`master` 브랜치는 번역물이 들어가는 곳이 아닙니다.

-`.po` 파일의 일부만 번역하지 마시고 파일 전체를 번역한 후에 PR 주세요.

일부 파일들은 꽤 큽니다. 마무리할 수 있을지 미리 확인해 보시고 시작해주세요.

- 교정이 끝난 최종본을 PR 해 주세요. 띄어쓰기, 철자 검사는 필수입니다.

`pdkwatch` 할 때 없던 경고가 생기지 않도록 확인 바랍니다.

`pdkbuild` 할 때 없던 경고가 생기지 않도록 확인 바랍니다.

- 어떤 경우에도`msgid` 는 변경하지 마시고,`msgstr` 부분만 변경해주세요.

- 마크업 (`` :ref:`...```,`*term*`,`` `... <...>`_``, ...) 뒤에 조사가 공백없이 연결되면 마크업으로 인식되지 않습니다.

띄어쓰기 없이 마크업을 분리하려면`\\`를 삽입해주세요.

예를 들어,`` :dfn:`comprehension``` 은`` :dfn:`컴프리헨션 (comprehension)``` 으로 번역합니다.

- "파이썬 자습서"는 "...입니다" 스타일인 반면, "파이썬 언어 레퍼런스"는 "...다" 스타일입니다.

"파이썬 언어 레퍼런스" 이외의 모든 문서는 "파이썬 자습서" 스타일을 유지해주세요.

- 가능하면 긴`msgstr` 은 여러 줄 로 나눠주세요.

그래야 웹에서 리뷰할 때 편합니다.

줄 나누기 할 때 필요한 공백이 빠지지 않도록 조심하시고요.

- 드물긴 하지만 때로 원문에 오류가 있을 수도 있습니다.

특히 실제로 동작하지 않는 무의미한 마크업이 존재하기도 합니다.

이 경우 마크업을 제거하지 마시고 그대로 유지해주세요.