Skip to content

Commit e116cb1

Browse files
authored
Merge pull request #23215 from shuuji3/contribute/style/content-guide
Translate contribute/style/content-guide into Japanese
2 parents 3387b53 + 6282940 commit e116cb1

File tree

1 file changed

+62
-0
lines changed

1 file changed

+62
-0
lines changed
Lines changed: 62 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,62 @@
1+
---
2+
title: ドキュメントコンテンツガイド
3+
linktitle: コンテンツガイド
4+
content_type: concept
5+
weight: 10
6+
---
7+
8+
<!-- overview -->
9+
10+
このページでは、Kubernetesのドキュメント上のコンテンツのガイドラインを説明します。
11+
12+
許可されるコンテンツに関して疑問がある場合は、[Kubernetes Slack](https://slack.k8s.io/)の#sig-docsチャンネルに参加して質問してください!
13+
14+
Kubernetes Slackには、<https://slack.k8s.io/> から参加登録ができます。
15+
16+
Kubernetesドキュメントの新しいコンテンツの作成に関する情報については、[スタイルガイド](/docs/contribute/style/style-guide)に従ってください。
17+
18+
<!-- body -->
19+
20+
## 概要
21+
22+
ドキュメントを含むKubernetesのウェブサイトのソースは、[kubernetes/website](https://github.com/kubernetes/website)リポジトリに置かれています。
23+
24+
Kubernetesの主要なドキュメントは`kubernetes/website/content/<language_code>/docs`フォルダに置かれており、これらは[Kubernetesプロジェクト](https://github.com/kubernetes/kubernetes)を対象としています。
25+
26+
## 許可されるコンテンツ
27+
28+
Kubernetesのドキュメントにサードパーティーのコンテンツを掲載することが許されるのは、次の場合のみです。
29+
30+
- コンテンツがKubernetesプロジェクト内のソフトウェアのドキュメントとなる場合
31+
- コンテンツがプロジェクト外のソフトウェアのドキュメントとなるが、Kubernetesを機能させるために必要である場合
32+
- コンテンツがkubernetes.ioの正規のコンテンツであるか、他の場所の正規のコンテンツへのリンクである場合
33+
34+
### サードパーティーのコンテンツ
35+
36+
Kubernetesのドキュメントには、Kubernetesプロジェクト([kubernetes](https://github.com/kubernetes)および[kubernetes-sigs](https://github.com/kubernetes-sigs) GitHub organizationsに存在するプロジェクト)の適用例が含まれています。
37+
38+
Kubernetesプロジェクト内のアクティブなコンテンツへのリンクは常に許可されます。
39+
40+
Kubernetesを機能させるためには、一部サードパーティーのコンテンツが必要です。たとえば、コンテナランタイム(containerd、CRI-O、Docker)、[ネットワークポリシー](/docs/concepts/extend-kubernetes/compute-storage-net/network-plugins/)(CNI plugin)、[Ingressコントローラー](/ja/docs/concepts/services-networking/ingress-controllers/)[ロギング](/docs/concepts/cluster-administration/logging/)などです。
41+
42+
ドキュメント内で、Kubernetesプロジェクト外のサードパーティーのオープンソースソフトウェア(OSS)にリンクすることができるのは、Kubernetesを機能させるために必要な場合のみです。
43+
44+
### 情報源が重複するコンテンツ
45+
46+
可能な限り、Kubernetesのドキュメントは正規の情報源にリンクするようにし、情報源が重複してしまうようなホスティングは行いません。
47+
48+
情報源が重複したコンテンツは、メンテナンスするために2倍の労力(あるいはそれ以上!)が必要になり、より早く情報が古くなってしまいます。
49+
50+
{{< note >}}
51+
52+
あなたがKubernetesのプロジェクトのメンテナーであり、ドキュメントのホスティングに関して手助けが必要なときは、[Kubernetes Slackの#sig-docs](https://kubernetes.slack.com/messages/C1J0BPD2M/)で教えてください。
53+
54+
{{< /note >}}
55+
56+
### その他の情報
57+
58+
許可されるコンテンツに関して疑問がある場合は、[Kubernetes Slack](https://slack.k8s.io/)の#sig-docsチャンネルに参加して質問してください!
59+
60+
## {{% heading "whatsnext" %}}
61+
62+
* [スタイルガイド](/docs/contribute/style/style-guide)を読む

0 commit comments

Comments
 (0)