권장 사항

Lunaria는 오픈소스 커뮤니티가 복잡한 현지화 프로젝트를 해결하는 데 도움을 주기 위해 제작되었지만, 도구만으로는 여정의 절반에 불과합니다.

이 페이지에서는 프로젝트의 일상적인 운영을 개선하고, 더 효과적으로 Lunaria를 활용하며 기여자와 유지보수자의 삶을 풍요롭게 만들기 위한 우리의 권고사항을 나열합니다.

압축 병합 커밋을 선호하세요

Lunaria의 깃 기반 추적 시스템은 기본적으로 모든 커밋을 고려합니다. 메인 브랜치에 여러 커밋이 병합될 경우, 각각의 커밋과 변경된 파일은 제목 및 기타 메타데이터에 따라 서로 다른 상태를 가지게 됩니다.

이러한 이유로 압축 병합 커밋은 하나의 피드백 요청 기준으로 상태 변경이 이루어지도록 함으로써, 커밋 단위가 아니라 피드백 요청 단위로 추적 시스템이 예측 가능하게 유지되는 좋은 방법입니다.

피드백 요청을 작게 유지하세요

지속적으로 변화하는 활성화된 프로젝트에서는 원본 내용이 피드백 요청이 검토 중일 때 변경된 경우, 현지화 피드백 요청에서 어떤 콘텐츠가 누락되었는지 추적하고 확인하는 것이 어려워질 수 있습니다.

각 피드백 요청마다 작은 변경만 하면, 누락된 변경사항을 추적하기 쉬워지는 동시에 리뷰어가 쉽게 참여하여 현지화 콘텐츠의 품질을 보장할 수 있도록 해줍니다.

커뮤니티에 지침을 제공하세요

여러 기여자가 실제로는 Lunaria나 오픈소스 기여에 익숙하지 않을 수 있습니다. 그러므로 전체 프로세스를 문서화하는 것이 매우 중요하며, 새로운 기여자가 좌절하지 않도록 하고, 유지보수자가 기여자를 도와주는 데 어려움을 겪지 않도록 해야 합니다.

아스트로 문서의 국제화 가이드는 참고할 만한 좋은 예시입니다. 전반적으로 현지화 문서는 다음 주제들을 대부분 언급해야 합니다:

• 시작하기 위한 조건은 무엇인가요? (도구, 사전 경험 등)
• 현지화 구조는 어떻게 되나요? (콘텐츠는 어디에 있으며, X 또는 Y는 어떻게 현지화되나요, 등)
• 기여자는 어떻게 도울 수 있나요? (도움이 가장 필요한 부분, 기여할 내용을 찾는 방법 등)