KubeCon に刺激を受けて、Kubernetesドキュメントの日本語翻訳をやってみた

Transcript

1. KubeConに刺激を受けて、 Kubernetesドキュメントの日本語翻訳をやってみた Kubernetes Novice Tokyo #42 2026/10/06（火） Kubernetes Novice Tokyo #42 · 2026/10/06（火） 1
2. 自己紹介 じぇまき 某社のエンジニア Terraform・Kubernetes・EKSが主な領域 まだ半袖勢です Kubernetes Novice Tokyo #42 · 2026/10/06（火） 2
3. 今日は Novice Tokyoなので、ゆるい話をします！ Kubernetes Novice Tokyo #42 · 2026/10/06（火） 3
4. 今年のKubeConも楽しかったですよね！ AI周りの話もやはり多かった とはいえ、プラットフォームエンジニアリング等 の話も充実していた 去年よりもさらに熱を帯びていた気がする Kubernetes Novice Tokyo #42 · 2026/10/06（火） 4
5. ドキュメントの翻訳周りのセッションもいくつかあった Your First Kubernetes Contribution: A Hands-on Guide to Documentation Localization ドキュメント翻訳を入口に、最初の貢献を進める手順 Beyond Translation: The Journey of Building the Japanese Kubernetes SIG Docs Community 日本語翻訳コミュニティの取り組みと、新しい貢献者の参加方法 Kubernetes Novice Tokyo #42 · 2026/10/06（火） 5
6. 特にAoiさんの話を聞いて、自分もやってみたくなった Aoiさんは去年のKubeConでOkabeさんのセッションを聞いて、翻訳を始めた そう ドキュメント翻訳なら自分にも貢献できるかもしれない、と思ったという話 (前々からやりたいと思っていたが)これを聞いて自分も刺激を受けて、初めて翻 訳をやってみることにした セッション動画: Beyond Translation Kubernetes Novice Tokyo #42 · 2026/10/06（火） 6
7. ちょうど良いタイミングでOkabeさんがやりやすいIssueをたくさん切っ てくれた Okabeさん神 Slackでの案内 Kubernetes Novice Tokyo #42 · 2026/10/06（火） 7
8. あとはIssueを拾ってやるだけなので、すぐやる 取り組んだIssue: #56700 / 翻訳PR: #56997 数行ほどの翻訳 翻訳ガイド等に必要な情報が揃っていて、特に迷わなかった Slackもみんなが活発に会話していたので、気軽に相談できる環境 Kubernetes Novice Tokyo #42 · 2026/10/06（火） 8
9. 翻訳中に原文の間違いに気がついたので、ついでにPRを投げる 原文修正PR: #57143 A type of container type that you can temporarily run inside a Pod の重複を直して、ピリオドを追加しただけ 小さな修正なので、特にIssueも作らず投げてサクッとレビューしてもらい、その数週間後 に /approve がついてマージされた ツールチップでいろいろなところに表示されるので、ちょっと得した気分になる type Kubernetes Novice Tokyo #42 · 2026/10/06（火） 9
10. やってみてよかったこと Kubernetes Novice Tokyo #42 · 2026/10/06（火） 10
11. 少しの追加・修正でも、マージされて反映されるとやっぱり嬉しい これに尽きる Kubernetes Novice Tokyo #42 · 2026/10/06（火） 11
12. 翻訳した際の副産物 自分はプラットフォームエンジニアリングをしていて、ドキュメントをよく書い ているが、規約として日本語翻訳ガイドがとても参考になった 例えば、括弧と句点の位置、カタカナ語の長音、Podなどの用語表記 ドキュメントのリポジトリのMarkdownファイルに規約を書いておき、成果物に AIレビューをさせている 翻訳ガイドは規約がきちんと構造化されているのが嬉しい Kubernetes日本語翻訳ガイド Kubernetes Novice Tokyo #42 · 2026/10/06（火） 12
13. AI Guidanceが参考になった AIを使ってPRを書くのはOK。使用はPR本文に明記し、変更は全部自分で理解 する レビュアーに渡す前に自分で確認する。レビューへの返答はAIに頼らず自分です る 使っていいけど、最後まで自分で責任を持つ、というのが端的に書かれていて参 考になった ガイドとして明文化されているのが素晴らしい Kubernetes公式ガイド: AI Guidance Kubernetes Novice Tokyo #42 · 2026/10/06（火） 13
14. まとめ ドキュメント翻訳やってみた。今後もやっていきたい ドキュメントの観点で仕事にも役立った あなたもぜひやってみてはいかが？ Kubernetes Novice Tokyo #42 · 2026/10/06（火） 14
15. ご清聴ありがとうございました！ Kubernetes Novice Tokyo #42 · 2026/10/06（火） 15
16. 参考リンク Your First Kubernetes Contribution Beyond Translation 最初の翻訳Issue #56700 日本語翻訳PR #56997 英語の原文修正PR #57143 Kubernetes日本語翻訳ガイド Kubernetes公式ガイド: AI Guidance Kubernetes Novice Tokyo #42 · 2026/10/06（火） 16