17
17
18
18
{{< note >}}
19
19
Kubernetesへの貢献について総合的に知りたい場合は、[ contributor documentation] ( https://www.kubernetes.dev/docs/ ) を参照してください。
20
+
21
+ また、Kubernetesへの貢献については、{{< glossary_tooltip text="CNCF" term_id="cncf" >}}の[ ページ] ( https://contribute.cncf.io/contributors/projects/#kubernetes ) を参照することもできます。
20
22
{{< /note >}}
21
23
24
+ ---
25
+
22
26
このウェブサイトは[ Kubernetes SIG Docs] ( /docs/contribute/#get-involved-with-sig-docs ) が管理しています。
23
27
24
28
Kubernetesドキュメントコントリビューターは
@@ -41,17 +45,102 @@ Kubernetesコミュニティで効果的に働くためには、[git](https://gi
41
45
2 . [ ドキュメンテーションのリポジトリー] ( https://github.com/kubernetes/website ) と、ウェブサイトの[ 静的サイトジェネレーター] ( https://gohugo.io ) に慣れ親しんでください。
42
46
3 . [ プルリクエストのオープン] ( /docs/contribute/new-content/open-a-pr/ ) と[ 変更レビュー] ( /ja/docs/contribute/review/reviewing-prs/ ) の基本的なプロセスを理解していることを確認してください。
43
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は新たな貢献者のためのロードマップを概説しています。` サインアップ ` や` レビュー ` のステップのいくつか、またはその全てに従えばよいです。これで、` プルリクエストのオープン ` の下にリストされているいくつかの貢献目標を達成するためのプルリクエストを開く準備が整いました。また、質問はいつでも歓迎です!
94
+
44
95
一部のタスクでは、Kubernetes organizationで、より多くの信頼とアクセス権限が必要です。
45
96
役割と権限についての詳細は、[ SIG Docsへの参加] ( /ja/docs/contribute/participate/ ) を参照してください。
46
97
47
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
+
48
133
- 貢献のための複数の方法について学ぶために[ 貢献の概要] ( /ja/docs/contribute/new-content/overview/ ) を読んでください。
49
134
- 良い開始地点を探すために[ ` kubernetes/website ` issueリスト] ( https://github.com/kubernetes/website/issues/ ) を確認してください。
50
135
- 既存のドキュメントに対して[ GitHubを使ってプルリクエストをオープン] ( /docs/contribute/new-content/open-a-pr/#changes-using-github ) し、GitHubへのissueの登録について学んでください。
51
136
- 正確さと言語の校正のため、他のKubernetesコミュニティメンバーから[ プルリクエストのレビュー] ( /docs/contribute/review/reviewing-prs/ ) を受けてください。
52
137
- 見識のあるコメントを残せるようにするため、Kubernetesの[ コンテンツ] ( /ja/docs/contribute/style/content-guide/ ) と[ スタイルガイド] ( /docs/contribute/style/style-guide/ ) を読んでください。
53
138
- [ ページコンテンツの種類] ( /docs/contribute/style/page-content-types/ ) と[ Hugoショートコード] ( /docs/contribute/style/hugo-shortcodes/ ) について勉強してください。
54
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
+
55
144
## 次のステップ
56
145
57
146
- リポジトリの[ ローカルクローンでの作業] ( /docs/contribute/new-content/open-a-pr/#fork-the-repo ) について学んでください。
@@ -73,4 +162,5 @@ SIG Docsは複数の方法でコミュニケーションをとっています。
73
162
74
163
- [ Kubernetesコミュニティサイト] ( /community/ ) を訪問してください。TwitterやStack Overflowに参加したり、Kubernetesの集会やイベントについて学んだりしてください。
75
164
- 機能開発に貢献したい方は、まずはじめに[ Kubernetesコントリビューターチートシート] ( https://github.com/kubernetes/community/tree/master/contributors/guide/contributor-cheatsheet ) を読んでください。
165
+ - [ Kubernetesの貢献者] ( https://www.kubernetes.dev/ ) や[ 追加の貢献者向けリソース] ( https://www.kubernetes.dev/resources/ ) についてもっと学ぶために、貢献者サイトを読んでください。
76
166
- [ ブログ記事やケーススタディ] ( /docs/contribute/new-content/blogs-case-studies/ ) を投稿してください。
0 commit comments