|
1 | 1 | --- |
2 | 2 | content_type: concept |
3 | | -title: K8sのドキュメントに貢献する |
4 | | -linktitle: 貢献 |
| 3 | +title: Kubernetesに貢献する |
| 4 | +linkTitle: 貢献 |
5 | 5 | main_menu: true |
6 | 6 | no_list: true |
7 | 7 | weight: 80 |
8 | 8 | card: |
9 | 9 | name: 貢献 |
10 | 10 | weight: 10 |
11 | | - title: K8sへの貢献を始める |
| 11 | + title: Kubernetesに貢献する |
12 | 12 | --- |
13 | 13 |
|
14 | 14 | <!-- overview --> |
15 | 15 |
|
16 | | -*Kubernetesは初心者でも経験者でも、全てのコントリビューターからの改善を歓迎しています!* |
| 16 | +Kubernetesに貢献する方法はたくさんあります。 |
| 17 | +新機能の設計に取り組むこともできますし、既存のコードにドキュメントを追加することも、[ブログ](/ja/blog)で記事を書くこともできます。 |
| 18 | +それだけではありません。新機能を実装したり、バグを修正したりすることもできます。 |
| 19 | +貢献者コミュニティへの参加を支援することも、既存の貢献者をサポートすることもできます。 |
17 | 20 |
|
18 | | -{{< note >}} |
19 | | -Kubernetesへの貢献について総合的に知りたい場合は、[contributor documentation](https://www.kubernetes.dev/docs/)を参照してください。 |
| 21 | +様々な方法でプロジェクトに貢献することができるため、Kubernetesは https://k8s.dev/ という専用のウェブサイトを作成しました。 |
| 22 | +Kubernetesへの貢献についてもっと学ぶために、参照することができます。 |
20 | 23 |
|
21 | | -また、Kubernetesへの貢献については、{{< glossary_tooltip text="CNCF" term_id="cncf" >}}の[ページ](https://contribute.cncf.io/contributors/projects/#kubernetes)を参照することもできます。 |
22 | | -{{< /note >}} |
23 | | - |
24 | | ---- |
25 | | - |
26 | | -このウェブサイトは[Kubernetes SIG Docs](/docs/contribute/#get-involved-with-sig-docs)が管理しています。 |
27 | | - |
28 | | -Kubernetesドキュメントコントリビューターは |
29 | | - |
30 | | -- 既存のコンテンツを改善します |
31 | | -- 新しいコンテンツを作成します |
32 | | -- ドキュメントを翻訳します |
33 | | -- Kubernetesリリースサイクルの一部としてドキュメントを管理・公開します |
34 | | - |
35 | | -<!-- body --> |
36 | | - |
37 | | -## はじめに |
38 | | - |
39 | | -どなたでも、問題を説明するissueや、ドキュメントの改善を求めるissueを作成し、[`kubernetes/website` GitHub リポジトリ](https://github.com/kubernetes/website)に対するプルリクエスト(PR)を用いて変更に貢献することができます。 |
40 | | -Kubernetesコミュニティで効果的に働くためには、[git](https://git-scm.com/)と[GitHub](https://skills.github.com/)を基本的に使いこなせる必要があります。 |
41 | | - |
42 | | -ドキュメンテーションに関わるには: |
43 | | - |
44 | | -1. CNCFの[Contributor License Agreement](https://github.com/kubernetes/community/blob/master/CLA.md)にサインしてください。 |
45 | | -2. [ドキュメンテーションのリポジトリー](https://github.com/kubernetes/website)と、ウェブサイトの[静的サイトジェネレーター](https://gohugo.io)に慣れ親しんでください。 |
46 | | -3. [プルリクエストのオープン](/docs/contribute/new-content/open-a-pr/)と[変更レビュー](/ja/docs/contribute/review/reviewing-prs/)の基本的なプロセスを理解していることを確認してください。 |
47 | | - |
48 | | -<!-- See https://github.com/kubernetes/website/issues/28808 for live-editor URL to this figure --> |
49 | | -<!-- You can also cut/paste the mermaid code into the live editor at https://mermaid-js.github.io/mermaid-live-editor to play around with it --> |
50 | | - |
51 | | -{{< mermaid >}} |
52 | | -flowchart TB |
53 | | -subgraph third[プルリクエストのオープン] |
54 | | -direction TB |
55 | | -U[ ] -.- |
56 | | -Q[コンテンツを改善する] --- N[コンテンツを作成する] |
57 | | -N --- O[ドキュメントを翻訳する] |
58 | | -O --- P[k8sリリースサイクルの <br>ドキュメントを管理する] |
59 | | - |
60 | | -end |
61 | | - |
62 | | -subgraph second[レビュー] |
63 | | -direction TB |
64 | | - T[ ] -.- |
65 | | - D[kubernetes/website <br>リポジトリを確認する] --- E[静的サイトジェネレータ <br>Hugoを確認する] |
66 | | - E --- F[基本的なGitHubの <br>コマンドを理解する] |
67 | | - F --- G[オープンした <br>プルリクエストを確認し <br>レビュープロセスを見直す] |
68 | | -end |
69 | | - |
70 | | -subgraph first[サインアップ] |
71 | | - direction TB |
72 | | - S[ ] -.- |
73 | | - B[CNCFの <br>貢献者ライセンス <br>契約に署名する] --- C[Slackチャンネル <br>sig-docs に<br>参加する] |
74 | | - C --- V[kubernetes-sig-docsの<br> メーリングリストに <br>参加する] |
75 | | - V --- M[毎週開催している <br>sig-docs callsや<br> slack callsに <br>参加する] |
76 | | -end |
77 | | - |
78 | | -A([fa:fa-user 新たな<br>貢献者]) --> first |
79 | | -A --> second |
80 | | -A --> third |
81 | | -A --> H[質問をする!!!] |
82 | | - |
83 | | - |
84 | | -classDef grey fill:#dddddd,stroke:#ffffff,stroke-width:px,color:#000000, font-size:15px; |
85 | | -classDef white fill:#ffffff,stroke:#000,stroke-width:px,color:#000,font-weight:bold |
86 | | -classDef spacewhite fill:#ffffff,stroke:#fff,stroke-width:0px,color:#000 |
87 | | -class A,B,C,D,E,F,G,H,M,Q,N,O,P,V grey |
88 | | -class S,T,U spacewhite |
89 | | -class first,second,third white |
90 | | -{{</ mermaid >}} |
91 | | -図1. 新たな貢献者のためのスタートガイド。 |
92 | | - |
93 | | -図1は新たな貢献者のためのロードマップを概説しています。`サインアップ`や`レビュー`のステップのいくつか、またはその全てに従えばよいです。これで、`プルリクエストのオープン`の下にリストされているいくつかの貢献目標を達成するためのプルリクエストを開く準備が整いました。また、質問はいつでも歓迎です! |
| 24 | +もし _この_ ドキュメントへの貢献について特に学びたい場合は、[Kubernetesドキュメントへの貢献](/ja/docs/contribute/docs/)を参照してください。 |
94 | 25 |
|
95 | | -一部のタスクでは、Kubernetes organizationで、より多くの信頼とアクセス権限が必要です。 |
96 | | -役割と権限についての詳細は、[SIG Docsへの参加](/ja/docs/contribute/participate/)を参照してください。 |
97 | | - |
98 | | -## はじめての貢献 |
99 | | - |
100 | | -あらかじめいくつかのステップを見直すことで、最初の貢献に備えることができます。図2はそれらのステップの概説で、詳細は次のとおりです。 |
101 | | - |
102 | | -<!-- See https://github.com/kubernetes/website/issues/28808 for live-editor URL to this figure --> |
103 | | -<!-- You can also cut/paste the mermaid code into the live editor at https://mermaid-js.github.io/mermaid-live-editor to play around with it --> |
104 | | - |
105 | | -{{< mermaid >}} |
106 | | -flowchart LR |
107 | | - subgraph second[はじめての貢献] |
108 | | - direction TB |
109 | | - S[ ] -.- |
110 | | - G[K8sメンバーからの <br>PRレビューを受ける] --> |
111 | | - A[最初のPRを作成するための <br>良いissueを <br>kubernetes/websiteから探す] --> B[PRをオープンする!!] |
112 | | - end |
113 | | - subgraph first[推奨される準備] |
114 | | - direction TB |
115 | | - T[ ] -.- |
116 | | - D[貢献者の概要を読む] -->E[K8sのコンテンツと<br> スタイルガイドを読む] |
117 | | - E --> F[Hugoのページコンテンツタイプと <br>ショートコードについて学ぶ] |
118 | | - end |
119 | | - |
120 | | - |
121 | | - first ----> second |
122 | | - |
123 | | - |
124 | | -classDef grey fill:#dddddd,stroke:#ffffff,stroke-width:px,color:#000000, font-size:15px; |
125 | | -classDef white fill:#ffffff,stroke:#000,stroke-width:px,color:#000,font-weight:bold |
126 | | -classDef spacewhite fill:#ffffff,stroke:#fff,stroke-width:0px,color:#000 |
127 | | -class A,B,D,E,F,G grey |
128 | | -class S,T spacewhite |
129 | | -class first,second white |
130 | | -{{</ mermaid >}} |
131 | | -図2. はじめての貢献のための準備。 |
132 | | - |
133 | | -- 貢献のための複数の方法について学ぶために[貢献の概要](/ja/docs/contribute/new-content/)を読んでください。 |
134 | | -- 良い開始地点を探すために[`kubernetes/website` issueリスト](https://github.com/kubernetes/website/issues/)を確認してください。 |
135 | | -- 既存のドキュメントに対して[GitHubを使ってプルリクエストをオープン](/docs/contribute/new-content/open-a-pr/#changes-using-github)し、GitHubへのissueの登録について学んでください。 |
136 | | -- 正確さと言語の校正のため、他のKubernetesコミュニティメンバーから[プルリクエストのレビュー](/docs/contribute/review/reviewing-prs/)を受けてください。 |
137 | | -- 見識のあるコメントを残せるようにするため、Kubernetesの[コンテンツ](/ja/docs/contribute/style/content-guide/)と[スタイルガイド](/docs/contribute/style/style-guide/)を読んでください。 |
138 | | -- [ページコンテンツの種類](/docs/contribute/style/page-content-types/)と[Hugoショートコード](/docs/contribute/style/hugo-shortcodes/)について勉強してください。 |
139 | | - |
140 | | -## 貢献時の支援の受け方 |
141 | | - |
142 | | -はじめて貢献を行うのは大変なことかもしれません。[新規貢献者のためのアンバサダー](https://github.com/kubernetes/website#new-contributor-ambassadors)は、最初の数回の貢献を行う手助けをしてくれます。[Kubernetes Slack](https://slack.k8s.io/)で、特に`#sig-docs`チャンネルを用いて連絡を取ることができます。また毎月第一火曜日に行われる[新規貢献者のための歓迎会](https://www.kubernetes.dev/resources/calendar/)もあります。ここで新規貢献者のアンバサダーと交流し、質問に答えてもらうことができます。 |
143 | | - |
144 | | -## 次のステップ |
145 | | - |
146 | | -- リポジトリの[ローカルクローンでの作業](/docs/contribute/new-content/open-a-pr/#fork-the-repo)について学んでください。 |
147 | | -- [リリース機能](/docs/contribute/new-content/new-features/)について記載してください。 |
148 | | -- [SIG Docs](/ja/docs/contribute/participate/)に参加し、[memberやreviewer](/docs/contribute/participate/roles-and-responsibilities/)になってください。 |
149 | | -- [国際化](/ja/docs/contribute/localization/)を始めたり、支援したりしてください。 |
150 | | - |
151 | | -## SIG Docsに参加する |
152 | | - |
153 | | -[SIG Docs](/ja/docs/contribute/participate/)はKubernetesのドキュメントとウェブサイトを公開・管理するコントリビューターのグループです。SIG Docsに参加することはKubernetesコントリビューター(機能開発でもそれ以外でも)にとってKubernetesプロジェクトに大きな影響を与える素晴らしい方法の一つです。 |
154 | | - |
155 | | -SIG Docsは複数の方法でコミュニケーションをとっています。 |
156 | | - |
157 | | -- [Kubernetes Slackインスタンスの`#sig-docs`に参加してください](https://slack.k8s.io/)。自己紹介を忘れずに! |
158 | | -- [`kubernetes-sig-docs`メーリングリストに参加してください](https://groups.google.com/forum/#!forum/kubernetes-sig-docs)。ここでは幅広い議論が起こり、公式な決定が記録されます。 |
159 | | -- [毎週のSIG Docsビデオミーティング](https://github.com/kubernetes/community/tree/master/sig-docs)に参加してください。ミーティングは `#sig-docs`でアナウンスされ、[Kubernetesコミュニティミーティングカレンダー](https://calendar.google.com/calendar/embed?src=cgnt364vd8s86hr2phapfjc6uk%40group.calendar.google.com&ctz=America/Los_Angeles)に追加されます。[Zoomクライアント](https://zoom.us/download)をダウンロードするか、電話を使って通話する必要があります。 |
160 | | - |
161 | | -## その他の貢献方法 |
162 | | - |
163 | | -- [Kubernetesコミュニティサイト](/community/)を訪問してください。TwitterやStack Overflowに参加したり、Kubernetesの集会やイベントについて学んだりしてください。 |
164 | | -- 機能開発に貢献したい方は、まずはじめに[Kubernetesコントリビューターチートシート](https://github.com/kubernetes/community/tree/master/contributors/guide/contributor-cheatsheet)を読んでください。 |
165 | | -- [Kubernetesの貢献者](https://www.kubernetes.dev/)や[追加の貢献者向けリソース](https://www.kubernetes.dev/resources/)についてもっと学ぶために、貢献者サイトを読んでください。 |
166 | | -- [ブログ記事やケーススタディ](/docs/contribute/new-content/blogs-case-studies/)を投稿してください。 |
| 26 | +また、Kubernetesへの貢献については、{{< glossary_tooltip text="CNCF" term_id="cncf" >}}の[ページ](https://contribute.cncf.io/contributors/projects/#kubernetes)を参照することもできます。 |
0 commit comments