Skip to content

Commit 296ab91

Browse files
Okabe-Junyat-inunasa9084
authored
[ja] Change the structure of /content/ja/docs/contribute/_index.md (#44826)
* update: fllowing upstream to content/ja/docs/home/_index.md * feat: add content/ja/docs/contribute/docs.md * update: fllowing upstream to content/ja/docs/contribute/_index.md * del: English origin * fix: minor fixes * update: meta data in docs.md * hotfix: revert missed operation during rebase * update: L126 Co-authored-by: inukai <[email protected]> * update: L17 Co-authored-by: nasa9084 <[email protected]> * update: L32 Co-authored-by: nasa9084 <[email protected]> * update: L38 Co-authored-by: nasa9084 <[email protected]> * update: L58 Co-authored-by: nasa9084 <[email protected]> * update: L146 Co-authored-by: nasa9084 <[email protected]> * update: L127 Co-authored-by: nasa9084 <[email protected]> * update: L128 Co-authored-by: nasa9084 <[email protected]> * update: L157 Co-authored-by: nasa9084 <[email protected]> * fix: L66 * feat: add note * fix: 貢献者 to コントリビューター * feat: add note --------- Co-authored-by: inukai <[email protected]> Co-authored-by: nasa9084 <[email protected]>
1 parent f3145e2 commit 296ab91

File tree

3 files changed

+176
-154
lines changed

3 files changed

+176
-154
lines changed

content/ja/docs/contribute/_index.md

Lines changed: 11 additions & 151 deletions
Original file line numberDiff line numberDiff line change
@@ -1,166 +1,26 @@
11
---
22
content_type: concept
3-
title: K8sのドキュメントに貢献する
4-
linktitle: 貢献
3+
title: Kubernetesに貢献する
4+
linkTitle: 貢献
55
main_menu: true
66
no_list: true
77
weight: 80
88
card:
99
name: 貢献
1010
weight: 10
11-
title: K8sへの貢献を始める
11+
title: Kubernetesに貢献する
1212
---
1313

1414
<!-- overview -->
1515

16-
*Kubernetesは初心者でも経験者でも、全てのコントリビューターからの改善を歓迎しています!*
16+
Kubernetesに貢献する方法はたくさんあります。
17+
新機能の設計に取り組むこともできますし、既存のコードにドキュメントを追加することも、[ブログ](/ja/blog)で記事を書くこともできます。
18+
それだけではありません。新機能を実装したり、バグを修正したりすることもできます。
19+
貢献者コミュニティへの参加を支援することも、既存の貢献者をサポートすることもできます。
1720

18-
{{< note >}}
19-
Kubernetesへの貢献について総合的に知りたい場合は、[contributor documentation](https://www.kubernetes.dev/docs/)を参照してください
21+
様々な方法でプロジェクトに貢献することができるため、Kubernetesは https://k8s.dev/ という専用のウェブサイトを作成しました。
22+
Kubernetesへの貢献についてもっと学ぶために、参照することができます
2023

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/)を参照してください。
9425

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

Comments
 (0)