Update Korean localization guide (#19004)

rev1-Update Korean localization guide

content/ko/docs/contribute/localization_ko.md

@@ -12,7 +12,7 @@ content_template: templates/concept
 
 {{% capture body %}}
 
-## 문체
+## 문체 가이드
 
 ### 높임말
 
@@ -42,9 +42,40 @@ content_template: templates/concept
 접시를 씻고 | 설거지를 하고
 가게에 배들, 사과들, 복숭아들이 있다 (과다한 복수형) | 가게에 배, 사과, 복숭아들이 있다
 
-### 한글과 영어 혼용에 관련한 원칙
+## 문서 코딩 가이드
 
-한글과 영어 단어 중 선택은 다음의 우선 순위를 따르나, 자연스럽지 않은 용어를 무리하게 선택하지는 않는다.
+### 가로폭은 원문을 따름
+
+유지보수의 편의를 위해서 원문의 가로폭을 따른다.
+
+즉, 원문이 한 문단을 줄바꿈하지 않고 한 행에 길게 기술했다면 한글화 시에도 한 행에 길게 기술하고, 원문이 한 문단을
+줄바꿈해서 여러 행으로 기술한 경우에는 한글화 시에도 가로폭을 원문과 비슷하게 유지한다.
+
+### 리뷰어 삭제
+
+때때로 원문의 코드 상단에 리뷰어가 명시되어 있는 경우가 있다. 일반적으로 원문 페이지의 리뷰어가 한글화 된 페이지를 리뷰하기 어려우므로 리소스 메타데이터에서 리뷰어 관련 코드를
+삭제한다.
+
+아래는 리뷰어 관련 코드를 삭제하는 예시를 보여준다.
+
+```diff
+- reviews:
+- - reviewer1
+- - reviewer
+- title: Kubernetes Components
++
++
++
++ title: 쿠버네티스 컴포넌트
+content_template: templates/concept
+weight: 10
+```
+
+## 용어 한글화 가이드
+
+### 용어 한글화의 일반적 방침
+
+영문 용어를 한글화할 때는 다음의 우선 순위를 따르나, 자연스럽지 않은 용어를 무리하게 선택하지는 않는다.
 
 * 한글 단어
   * 순 우리말 단어
@@ -52,13 +83,16 @@ content_template: templates/concept
 * 한영 병기 (예: 훅(hook))
 * 영어 단어 (예: Kubelet)
 
-단, 자연스러움을 판단하는 기준은 주관적이므로 다음의 [용어집](#용어집)과 기존에 번역된 문서를 참고한다.
+단, 자연스러움을 판단하는 기준은 주관적이므로 [한글화 용어집](#한글화-용어집)을 준용하고
+기존에 번역된 문서를 참고한다.
 
 {{% note %}}
 한영 병기는 페이지 내에서 해당 용어가 처음 사용되는 경우에만 적용하고 이후 부터는 한글만 표기한다.
 {{% /note %}}
 
-#### API 오브젝트는 외래어 표기법에 따라 한글 표기
+### API 오브젝트 용어 한글화 관련 방침
+
+API 오브젝트는 외래어 표기법에 따라 한글 표기한다.
 
 쿠버네티스 API 오브젝트는 원 단어를
 [국립국어원 외래어 표기법](http://kornorms.korean.go.kr/regltn/regltnView.do?regltn_code=0003#a)에
@@ -70,37 +104,43 @@ Deployment | 디플로이먼트
 Pod        | 파드
 Service    | 서비스
 
+{{% note %}}
+단, API 오브젝트 한글화 원칙에 예외가 있을 수 있으며, 이 경우에는 가능한
+[한글화 용어집](#한글화-용어집)을 준용한다. (예를 들면, Horizontal Pod Autoscaler
+는 API 오브젝트에 대해 외래어 표기법 적용하지 않고 원문 그대로 표기한다.)
+{{% /note %}}
+
 {{% note %}}
 API 오브젝트의 필드 이름, 파일 이름, 경로와 같은 내용은 독자가 구성 파일이나
 커맨드라인에서 그대로 사용할 가능성이 높으므로 한글로 옮기지 않고 원문을 유지한다.
 단, 주석에 포함된 내용은 한글로 옮길 수 있다.
 {{% /note %}}
 
-## 문서 코딩 가이드
+### 한글화 용어집 정보
 
-### 가로폭은 원문을 따름
+쿠버네티스 [한글화 용어집](#한글화-용어집)은 한글화된 쿠버네티스 문서의 일관성을 위해서
+각 영문 용어에 대한 한글화 방법을 제시한다.
+한글화 용어집에 포함된 용어는 쿠버네티스 문서 한글화팀 회의를 통해 결정되었으며,
+본 문서에 대한 ISSUE 및 PR을 통해서 개선한다.
 
-유지보수의 편의를 위해서 원문의 가로폭을 따른다. 
+#### 한글화 용어집 개선 가이드
 
-즉, 원문이 한 문단을 줄바꿈하지 않고 한 행에 길게 기술했다면 한글화 시에도 한 행에 길게 기술하고, 원문이 한 문단을 
+한글화 용어집의 개선(추가, 수정, 삭제 등)을 위한 과정은 다음과 같다.
-줄바꿈해서 여러 행으로 기술한 경우에는 한글화 시에도 가로폭을 원문과 비슷하게 유지한다.
 
-### 리뷰어 삭제
+1. 컨트리뷰터가 개선이 필요한 용어을 파악하면, ISSUE를 생성하여 개선 필요성을 공유하거나 `master` 브랜치에
+PR을 생성하여 개선된 용어를 제안한다.
 
-일반적으로 원문 페이지의 리뷰어가 한글 페이지를 리뷰하기 어려우므로 다음과 같이 리소스 메타데이터에서 리뷰어를 
+1. 개선 제안에 대한 논의는 ISSUE 및 PR을 통해서 이루어지며, 한글화팀 회의를 통해 확정한다.
-삭제한다.
 
-```diff
+1. 리뷰어 및 승인자는 작업 중인 한글화 작업 브랜치(예: dev-1.17-ko.3)에 영향을 최소화 하기 위해서,
-- reviews:
+신규 한글화 작업 브랜치(예: dev-1.17-ko.4) 생성 시점에 맞춰 확정된 PR을 승인한다.
-- - reviewer1
+개선된 한글화 용어집은 신규 한글화 작업 브랜치부터 적용한다.
-- - reviewer2
+
-- title: Kubernetes Components
+1. 개선된 한글화 용어집에 따라 기존의 한글 문서에 대한 업데이트가 필요하며,
-+ title: 쿠버네티스 컴포넌트
+컨트리뷰션을 통해서 업데이트를 진행한다.
-content_template: templates/concept
+
-weight: 10
+#### 한글화 용어집
-```
 
-## 용어집
 
 English | 한글 | 비고
 --- | --- | ---
@@ -304,4 +344,3 @@ Workload | 워크로드 |
 YAML | YAML |
 
 {{% /capture %}}
-