Kubernetes 문서 관례

Kubernetes 공식 문서는 OpenStack 과 달리 Hugo 와 Markdown 기반입니다. 본 프로젝트는 rST/Sphinx 로 작성하지만, Kubernetes 문서 기여까지 연결하려면 이 차이를 이해해야 합니다.

참고

기여자 작업용 골격입니다. Kubernetes 문서 기여 가이드를 확인하며 보강해 주세요.

핵심 출처

• Kubernetes Documentation (website) — https://kubernetes.io/docs/

• Contribute to Kubernetes docs — https://kubernetes.io/docs/contribute/

OpenStack 방식과의 차이

항목	OpenStack	Kubernetes
마크업	reStructuredText	Markdown
정적 사이트 생성기	Sphinx	Hugo
현지화(l10n)	i18n 팀 + (Weblate 전환)	언어별 디렉터리 + SIG Docs Localization
리뷰	Gerrit (대다수)	GitHub PR

왜 둘 다 알아야 하는가

두 생태계의 문서화 방식을 모두 경험하면, 같은 “오픈소스 문서 기여” 라도 도구·관례가 어떻게 다른지 체득할 수 있습니다. 이는 번역 작업(번역 · 국제화)에서 특히 유용합니다.