From 75cc9b0b96a0ebe197b04aaa87f0a5d18bdb2e2e Mon Sep 17 00:00:00 2001 From: Junya Okabe <86868255+Okabe-Junya@users.noreply.github.com> Date: Tue, 2 Jul 2024 10:05:49 +0900 Subject: [PATCH] Initialize the Japanese Localization Guidelines (#259) * feat: initialize Japanese l10n guide Signed-off-by: Junya Okabe * update: add review section Signed-off-by: Junya Okabe * fix: anchor link Signed-off-by: Junya Okabe * Update: l10n reviewer Signed-off-by: Junya Okabe <86868255+Okabe-Junya@users.noreply.github.com> Signed-off-by: Junya Okabe * fix: linter errors Signed-off-by: Junya Okabe * feat: add ## Localization READMEs Signed-off-by: Junya Okabe * fix: link checker error Signed-off-by: Junya Okabe * update: .prettierignore Signed-off-by: Junya Okabe * Update docs/localization/README.md Co-authored-by: Patrice Chalin Signed-off-by: Junya Okabe <86868255+Okabe-Junya@users.noreply.github.com> * Update .prettierignore Co-authored-by: Patrice Chalin Signed-off-by: Junya Okabe <86868255+Okabe-Junya@users.noreply.github.com> * fix: L6 Signed-off-by: Junya Okabe --------- Signed-off-by: Junya Okabe Signed-off-by: Junya Okabe <86868255+Okabe-Junya@users.noreply.github.com> Co-authored-by: Patrice Chalin --- .prettierignore | 2 +- docs/localization/README.md | 4 ++ docs/localization/ja/README.md | 73 ++++++++++++++++++++++++++++++++++ 3 files changed, 78 insertions(+), 1 deletion(-) create mode 100644 docs/localization/ja/README.md diff --git a/.prettierignore b/.prettierignore index ec634b6..f238ae8 100644 --- a/.prettierignore +++ b/.prettierignore @@ -1 +1 @@ -# Nothing to ignore at the moment. +/docs/localization/ja diff --git a/docs/localization/README.md b/docs/localization/README.md index aae60c1..9ca8025 100644 --- a/docs/localization/README.md +++ b/docs/localization/README.md @@ -11,3 +11,7 @@ Every guide here must meet the following requirements: - Meets the requirements of the original open-source license. Guides here must not violate copyright or licensing requirements. + +## Localizations + +- [Japanese](ja/README.md) diff --git a/docs/localization/ja/README.md b/docs/localization/ja/README.md new file mode 100644 index 0000000..265ff8b --- /dev/null +++ b/docs/localization/ja/README.md @@ -0,0 +1,73 @@ +# CNCF日本語ローカライゼーション向けガイドライン + +このドキュメントでは、CNCFのプロジェクトをローカライズする際に参考になる一般的なガイドラインを提供します。 + +> [!IMPORTANT] +> 各プロジェクトに対してこのガイドラインをどの程度適用するかは、各プロジェクトのローカライゼーションリードが決定します。疑問点がある場合は、各プロジェクトの日本語ローカライゼーションリードやレビュアーと相談してください。 + +## 目次 + +- [スタイルガイド](#スタイルガイド) +- [固有の用語](#固有の用語) + - [例](#例) +- [レビュー](#レビュー) +- [プロジェクト](#プロジェクト) +- [コミュニケーション](#コミュニケーション) + +## スタイルガイド + +Kubernetesの[日本語ローカライゼーション向けのスタイルガイド](https://kubernetes.io/ja/docs/contribute/localization/#style-guide)に準拠してください。 + +## 固有の用語 + +CNCFのプロジェクト特有の用語については、原則として英語のまま表記してください。ただしこれらの用語や概念を説明をするページなどで日本語の訳語が必要な場合は、以下の表を参考にしてください。 + +| 英語 | 日本語 | +| --- | --- | +| Charter | チャーター | +| Governing Board | 運営委員会 | +| SIG (Special Interest Group) | Special Interest Group | +| TAB (Technical Advisory Board) | 技術諮問評議会 | +| TAG (Technical Advisory Group) | 技術諮問グループ | +| TOC (Technical Oversight Committee) | 技術監督委員会 | +| WG (Working Group) | ワーキンググループ | + +また次の表に示す用語はCNCF特有ではありませんが、表記を統一するため、原則として以下の表を参考にしてください。 + +| 英語 | 日本語 | +| --- | --- | +| Committee | 委員会 | +| White Paper | ホワイトペーパー | + +### 例 + +| 推奨 | 非推奨 | +| --- | --- | +| Platform WG | プラットフォームWG | +| Platform WG | プラットフォームワーキンググループ | +| SIG Docs | SIGドキュメント | +| TAG Runtime | TAGランタイム | + +## レビュー + +ローカライゼーションのPRを作成した際は、ローカライゼーションレビュアーにレビューを依頼してください。各リポジトリのレビュアーは、[プロジェクト](#プロジェクト)の表を参考にしてください。 +2人以上のローカライゼーションレビュアーからの承認を得ることを推奨します。 + +ローカライゼーションレビュアーからの承認を得た後、各リポジトリのメンテナーにPRのマージを依頼してください。 + +## プロジェクト + +すでにローカライゼーションが進められているプロジェクトの一覧です。ローカライゼーションPRを作成する際には、以下の表を参考にして、適宜ローカライゼーションリードやレビュアーに通知してください。 + +| プロジェクト | ローカライゼーションリード | ローカライゼーションレビュアー | +| --- | --- | --- | +| [CNCF Glossary](https://github.com/cncf/glossary) | [@naonishijima](https://github.com/naonishijima) | [@naonishijima](https://github.com/naonishijima), [@kaitoii11](https://github.com/kaitoii11), [@Okabe-Junya](https://github.com/Okabe-Junya) | +| [CNCF TAG App Delivery](https://github.com/cncf/tag-app-delivery) | [@hhiroshell](https://github.com/hhiroshell) | [@hhiroshell](https://github.com/hhiroshell), [@kaitoii11](https://github.com/kaitoii11), [@naonishijima](https://github.com/naonishijima) | +| [CNCF TAG Environmental Sustainability](https://github.com/cncf/tag-env-sustainability) | [@naonishijima](https://github.com/naonishijima) | [@naonishijima](https://github.com/naonishijima), [@kaitoii11](https://github.com/kaitoii11), [@Okabe-Junya](https://github.com/Okabe-Junya) | +| [CNCF TAG Runtime](https://github.com/cncf/tag-runtime) | [@kaitoii11](https://github.com/kaitoii11) | [@kaitoii11](https://github.com/kaitoii11), [@kenta-iijima](https://github.com/kenta-iijima), [@Okabe-Junya](https://github.com/Okabe-Junya) | + +## コミュニケーション + +CNCFのプロジェクトのローカライゼーションに関するコミュニケーションは、主に、[CNCFのSlack](https://cloud-native.slack.com)の[`#glossary-localization-japanese`](https://cloud-native.slack.com/archives/C057F81GFUG)チャンネルで行われています。ローカライゼーションに関する質問や提案がある場合は、こちらのチャンネルで議論してください。 + +CNCFのSlackに参加していない場合は、[Community Inviterのサイト](https://communityinviter.com/apps/cloud-native/cncf)から参加できます。