Skip to content

Commit

Permalink
[ja] Following the upstream for `/content/ja/docs/contribute/_index.m…
Browse files Browse the repository at this point in the history
…d` (#44182)

* Initial Commit

* cp: copy from content/en/docs/contribute/_index.md to content/ja/docs/contribute/_index.md

* translate en to ja

* translate en to ja (in mermaid)

* update: condense the text into single-line

Co-authored-by: inukai <82919057+t-inu@users.noreply.github.com>

* update: L57: change the nouns to verbs

Co-authored-by: inukai <82919057+t-inu@users.noreply.github.com>

* update: L91: use figure <number>

Co-authored-by: inukai <82919057+t-inu@users.noreply.github.com>

* update: L131: use figure <number>

Co-authored-by: inukai <82919057+t-inu@users.noreply.github.com>

* update: del unnecessary empty

Co-authored-by: inukai <82919057+t-inu@users.noreply.github.com>

* update: L113: fix translation "suggestion"

Co-authored-by: inukai <82919057+t-inu@users.noreply.github.com>

* update: L100: use figure <number>

Co-authored-by: inukai <82919057+t-inu@users.noreply.github.com>

* update: L142

Co-authored-by: inukai <82919057+t-inu@users.noreply.github.com>

* update: L93

Co-authored-by: inukai <82919057+t-inu@users.noreply.github.com>

* update: L40: fix URI

---------

Co-authored-by: inukai <82919057+t-inu@users.noreply.github.com>
  • Loading branch information
Okabe-Junya and t-inu authored Jan 20, 2024
1 parent fbf9b4f commit 5333168
Showing 1 changed file with 90 additions and 0 deletions.
90 changes: 90 additions & 0 deletions content/ja/docs/contribute/_index.md
Original file line number Diff line number Diff line change
Expand Up @@ -17,8 +17,12 @@ card:

{{< note >}}
Kubernetesへの貢献について総合的に知りたい場合は、[contributor documentation](https://www.kubernetes.dev/docs/)を参照してください。

また、Kubernetesへの貢献については、{{< glossary_tooltip text="CNCF" term_id="cncf" >}}の[ページ](https://contribute.cncf.io/contributors/projects/#kubernetes)を参照することもできます。
{{< /note >}}

---

このウェブサイトは[Kubernetes SIG Docs](/docs/contribute/#get-involved-with-sig-docs)が管理しています。

Kubernetesドキュメントコントリビューターは
Expand All @@ -41,17 +45,102 @@ Kubernetesコミュニティで効果的に働くためには、[git](https://gi
2. [ドキュメンテーションのリポジトリー](https://github.com/kubernetes/website)と、ウェブサイトの[静的サイトジェネレーター](https://gohugo.io)に慣れ親しんでください。
3. [プルリクエストのオープン](/docs/contribute/new-content/open-a-pr/)[変更レビュー](/ja/docs/contribute/review/reviewing-prs/)の基本的なプロセスを理解していることを確認してください。

<!-- See https://github.com/kubernetes/website/issues/28808 for live-editor URL to this figure -->
<!-- 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 -->

{{< mermaid >}}
flowchart TB
subgraph third[プルリクエストのオープン]
direction TB
U[ ] -.-
Q[コンテンツを改善する] --- N[コンテンツを作成する]
N --- O[ドキュメントを翻訳する]
O --- P[k8sリリースサイクルの <br>ドキュメントを管理する]

end

subgraph second[レビュー]
direction TB
T[ ] -.-
D[kubernetes/website <br>リポジトリを確認する] --- E[静的サイトジェネレータ <br>Hugoを確認する]
E --- F[基本的なGitHubの <br>コマンドを理解する]
F --- G[オープンした <br>プルリクエストを確認し <br>レビュープロセスを見直す]
end

subgraph first[サインアップ]
direction TB
S[ ] -.-
B[CNCFの <br>貢献者ライセンス <br>契約に署名する] --- C[Slackチャンネル <br>sig-docs に<br>参加する]
C --- V[kubernetes-sig-docsの<br> メーリングリストに <br>参加する]
V --- M[毎週開催している <br>sig-docs callsや<br> slack callsに <br>参加する]
end

A([fa:fa-user 新たな<br>貢献者]) --> first
A --> second
A --> third
A --> H[質問をする!!!]


classDef grey fill:#dddddd,stroke:#ffffff,stroke-width:px,color:#000000, font-size:15px;
classDef white fill:#ffffff,stroke:#000,stroke-width:px,color:#000,font-weight:bold
classDef spacewhite fill:#ffffff,stroke:#fff,stroke-width:0px,color:#000
class A,B,C,D,E,F,G,H,M,Q,N,O,P,V grey
class S,T,U spacewhite
class first,second,third white
{{</ mermaid >}}
図1. 新たな貢献者のためのスタートガイド。

図1は新たな貢献者のためのロードマップを概説しています。`サインアップ``レビュー`のステップのいくつか、またはその全てに従えばよいです。これで、`プルリクエストのオープン`の下にリストされているいくつかの貢献目標を達成するためのプルリクエストを開く準備が整いました。また、質問はいつでも歓迎です!

一部のタスクでは、Kubernetes organizationで、より多くの信頼とアクセス権限が必要です。
役割と権限についての詳細は、[SIG Docsへの参加](/ja/docs/contribute/participate/)を参照してください。

## はじめての貢献

あらかじめいくつかのステップを見直すことで、最初の貢献に備えることができます。図2はそれらのステップの概説で、詳細は次のとおりです。

<!-- See https://github.com/kubernetes/website/issues/28808 for live-editor URL to this figure -->
<!-- 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 -->

{{< mermaid >}}
flowchart LR
subgraph second[はじめての貢献]
direction TB
S[ ] -.-
G[K8sメンバーからの <br>PRレビューを受ける] -->
A[最初のPRを作成するための <br>良いissueを <br>kubernetes/websiteから探す] --> B[PRをオープンする!!]
end
subgraph first[推奨される準備]
direction TB
T[ ] -.-
D[貢献者の概要を読む] -->E[K8sのコンテンツと<br> スタイルガイドを読む]
E --> F[Hugoのページコンテンツタイプと <br>ショートコードについて学ぶ]
end


first ----> second


classDef grey fill:#dddddd,stroke:#ffffff,stroke-width:px,color:#000000, font-size:15px;
classDef white fill:#ffffff,stroke:#000,stroke-width:px,color:#000,font-weight:bold
classDef spacewhite fill:#ffffff,stroke:#fff,stroke-width:0px,color:#000
class A,B,D,E,F,G grey
class S,T spacewhite
class first,second white
{{</ mermaid >}}
図2. はじめての貢献のための準備。

- 貢献のための複数の方法について学ぶために[貢献の概要](/ja/docs/contribute/new-content/overview/)を読んでください。
- 良い開始地点を探すために[`kubernetes/website` issueリスト](https://github.com/kubernetes/website/issues/)を確認してください。
- 既存のドキュメントに対して[GitHubを使ってプルリクエストをオープン](/docs/contribute/new-content/open-a-pr/#changes-using-github)し、GitHubへのissueの登録について学んでください。
- 正確さと言語の校正のため、他のKubernetesコミュニティメンバーから[プルリクエストのレビュー](/docs/contribute/review/reviewing-prs/)を受けてください。
- 見識のあるコメントを残せるようにするため、Kubernetesの[コンテンツ](/ja/docs/contribute/style/content-guide/)[スタイルガイド](/docs/contribute/style/style-guide/)を読んでください。
- [ページコンテンツの種類](/docs/contribute/style/page-content-types/)[Hugoショートコード](/docs/contribute/style/hugo-shortcodes/)について勉強してください。

## 貢献時の支援の受け方

はじめて貢献を行うのは大変なことかもしれません。[新規貢献者のためのアンバサダー](https://github.com/kubernetes/website#new-contributor-ambassadors)は、最初の数回の貢献を行う手助けをしてくれます。[Kubernetes Slack](https://slack.k8s.io/)で、特に`#sig-docs`チャンネルを用いて連絡を取ることができます。また毎月第一火曜日に行われる[新規貢献者のための歓迎会](https://www.kubernetes.dev/resources/calendar/)もあります。ここで新規貢献者のアンバサダーと交流し、質問に答えてもらうことができます。

## 次のステップ

- リポジトリの[ローカルクローンでの作業](/docs/contribute/new-content/open-a-pr/#fork-the-repo)について学んでください。
Expand All @@ -73,4 +162,5 @@ SIG Docsは複数の方法でコミュニケーションをとっています。

- [Kubernetesコミュニティサイト](/community/)を訪問してください。TwitterやStack Overflowに参加したり、Kubernetesの集会やイベントについて学んだりしてください。
- 機能開発に貢献したい方は、まずはじめに[Kubernetesコントリビューターチートシート](https://github.com/kubernetes/community/tree/master/contributors/guide/contributor-cheatsheet)を読んでください。
- [Kubernetesの貢献者](https://www.kubernetes.dev/)[追加の貢献者向けリソース](https://www.kubernetes.dev/resources/)についてもっと学ぶために、貢献者サイトを読んでください。
- [ブログ記事やケーススタディ](/docs/contribute/new-content/blogs-case-studies/)を投稿してください。

0 comments on commit 5333168

Please sign in to comment.