두 한글화 공동체의 만남: I18n SIG 와 SIG Docs

두 커뮤니티의 만남: SIG 활동의 역사와 현재 에서 살펴본 것처럼, OpenStack 과 Kubernetes 두 커뮤니티는 기술 통합을 위해 SIG(Special Interest Group)라는 형태로 공식적으로 만났습니다. 흥미롭게도 문서 한글화 영역에서도 같은 구도가 나타납니다. 두 프로젝트는 각각 번역·현지화를 책임지는 공동체를 두고 있으며, 본 프로젝트의 한글화 작업은 이 두 공동체가 만나는 지점에 서 있습니다.

참고

이 문서는 두 공동체의 구조를 나란히 비교하는 도입부 골격입니다. 각 공동체의 상세 워크플로우는 위에 링크된 개별 문서에서, 정확한 거버넌스 현황(역할 임명, 현행 도구)은 1차 출처를 확인하며 보강해 주세요.

OpenStack 측: I18n SIG

OpenStack 의 국제화는 I18n SIG 가 담당합니다. 언어별 번역팀(language team)을 중심으로 운영되며, 팀 안에는 번역가(translator), 리뷰어(reviewer), 코디네이터(coordinator) 같은 역할이 정의되어 있습니다. 한국어(ko_KR) 번역팀도 그중 하나입니다.

번역 플랫폼은 역사적으로 Zanata 를 사용해 왔으며, 커뮤니티 차원에서 Weblate 로의 이행이 진행되어 왔습니다 (Weblate). 자세한 내용은 OpenStack i18n 을 참고하세요.

Kubernetes 측: SIG Docs 현지화 하위 프로젝트

Kubernetes 의 문서 현지화는 SIG Docs 산하의 현지화(localization) 하위 프로젝트가 담당합니다. 언어별로 GitHub 팀과 OWNERS 파일, 그리고 language/ko 같은 라벨로 조직됩니다. 한국어(ko) 현지화 팀 역시 이 구조를 따릅니다.

OpenStack 과 달리 .po 메시지 번역이 아니라 언어별 디렉터리 (/content/ko/)에 Markdown 문서를 복제·번역하는 방식이며, 리뷰는 GitHub PR 중심입니다. 자세한 내용은 Kubernetes 현지화 을 참고하세요.

나란히 비교

항목

OpenStack I18n

Kubernetes SIG Docs 현지화

조직 형태

I18n SIG

SIG Docs 의 현지화 하위 프로젝트

한국어 단위

ko_KR 번역팀

ko 현지화 팀 (language/ko 라벨)

번역 단위

gettext .po 메시지

언어별 Markdown 파일 (/content/ko/)

도구/플랫폼

번역 플랫폼 (Zanata → Weblate)

GitHub (OWNERS 파일, Prow)

리뷰 방식

플랫폼 + 언어팀 리뷰

GitHub PR (owners/reviewers)

본 프로젝트의 위치

본 프로젝트는 이 두 공동체의 한글화 흐름을 모두 경험하는 것을 지향합니다. 서로 다른 두 방식(메시지 기반 번역 vs 파일 기반 현지화)을 함께 다뤄봄으로써, 같은 “한글화” 라도 프로젝트마다 도구·조직·리뷰 문화가 어떻게 다른지 체득할 수 있습니다. 이는 Kubernetes 문서 관례 에서 정리한 문서화 방식의 차이와도 직접 이어집니다.