[ja] Update content/ja/docs/contribute/localization.md

content/ja/docs/contribute/localization.md

@@ -66,12 +66,18 @@ card:
 - 数字とアルファベットは半角で表記
 - 記号類は感嘆符「！」と疑問符「？」のみ全角、それ以外は半角で表記
 - 英単語と日本語の間に半角スペースは不要
-  - また、カッコ`()`の前後にも半角スペースは不要
+  - 例: Kubernetesクラスター
+    - カッコ`()`の前後にも半角スペースは不要
+- 英語の単語間の半角スペースは削除しない
+  - 例: Kubernetes API
 - 日本語文では、文章の途中で改行を行わない。句点「。」で改行する
 - メタデータの`reviewer`の項目は削除する
 - すでに日本語訳が存在するページにリンクを張る場合は、`/ja/`を含めたURLを使用する
   - 例: `/path/to/page/`ではなく、`/ja/path/to/page/`を使用する
-
+- 理解のしやすい表記に変更する
+  - 例: `Kubernetesセキュリティ`ではなく、`Kubernetesのセキュリティ`を使用する　
+  - 例: `ベースライン`ではなく、`基本的な`を使用する
+
 ### 用語の表記 {#terminology}
 
 Kubernetesのリソース名や技術用語などは、原則としてそのままの表記を使用します。
@@ -82,6 +88,17 @@ Kubernetesのリソース名や技術用語などは、原則としてそのま
 またこれらの単語は、複数形ではなく単数形を用います。
 例えば、原文に"pods"と表記されている場合でも、日本語訳では"Pod"と表記してください。
 
+- そのままの表記を使用する単語リスト
+  - Kubernetes
+  - Pod
+  - Service
+  - Deployment
+  - Node
+  - Namespace
+  - etcd
+  - LoadBalancer
+
+
 ### 頻出表記(日本語) {#frequent-phrases}
 
 よくある表記 | あるべき形
@@ -95,14 +112,25 @@ Kubernetesのリソース名や技術用語などは、原則としてそのま
 カタカナ語に長音を付与するかどうかは、以下の原則に従ってください。
 
 - -er、-or、-ar、-cy、-gyで終わる単語は長音を付与する
-  - 例: 「クラスター」「セレクター」「サイドカー」「ポリシー」「トポロジー」
+  - 例: 「クラスター」「セレクター」「サイドカー」「ポリシー」「トポロジー」「コントローラー」
 - -ear、-eer、-re、-ty、-dy、-ryで終わる単語は長音を付与しない
   - 例: 「クリア」「エンジニア」「アーキテクチャ」「セキュリティ」「スタディ」「ディレクトリ」
 
 ただし、「コンテナ」は例外的に長音を付与しないこととします。
 
 この原則を作成するにあたって、[mozilla-japan/translation Editorial Guideline#カタカナ語の表記](https://github.com/mozilla-japan/translation/wiki/Editorial-Guideline#カタカナ語の表記)を参考にしました。
 
+### ヘッダーの翻訳 {#header}
+
+ページのヘッダーについては、以下の原則に従ってください。
+
+英語 | 翻訳有無
+--------- | ---------
+title: | タイトル（翻訳する）
+description: | 説明文（翻訳する）
+content_type: | content（翻訳しない）
+weight: | 100（翻訳しない）
+
 ### その他の表記 {#other-notation}
 
 その他の表記については、以下の表を参考にしてください。