CNCF TAG Appデリバリー – コントリビューション

Contribute: コミュニティ投稿ガイドライン

Mon, 01 Jan 0001 00:00:00 +0000

はじめに

本ポリシーは、コミュニティプラットフォームであるブログにおけるブログ投稿の受理、審査、公開に関するガイドラインを定めます。ブログ投稿は、メンバーや広範なオープンソースコミュニティからの多様な視点を紹介し、多様で活発な議論環境を育む機会となります。本コミュニティは出版社ではないため、グループの主目的は対話と協働の創出にあります。ブログ投稿もこの方針に沿いますが、コミュニティ公式出版物とみなされる執筆物ほど重視されません。

多様な視点の反映

コミュニティの声

当ブログはコミュニティメンバーの多様な見解を集約する場です。幅広い思考・経験・視点を反映することを重視しています。

免責事項の記載

各投稿には以下の短い免責事項を含めます：本ブログ記事は執筆者の見解を示すものであり、コミュニティまたは下部ワーキンググループの公式立場・視点を必ずしも反映するものではありません。投稿方法の詳細は当ブログおよび投稿ガイドラインをご参照ください。著者の現在の勤務先や関連製品に関する情報がブログに含まれる場合、免責事項内でその旨を明記する必要があります。

投稿・審査・承認基準

投稿プロセス

投稿者（コントリビューター）はブログ投稿をプルリクエスト（PR）として提出する必要があります。

審査プロセス

コミュニティコンテンツは、オープンソースコミュニティ内の善意ある全ての方によるレビューを受け付けます。これらのレビューはコンテンツの改善に活用され、コミュニティリーダーがブログの掲載可否を判断する材料となります。

掲載基準

ブログは、少なくとも1名のコミュニティリーダーの承認を得て初めて公開されます。コミュニティリーダーが評価する事項（非網羅的リスト）は以下の通りです：

コミュニティの理念・価値観との整合性
コミュニティメンバーへの関連性と有用性
特定のベンダーや製品からの独立性
内容の独創性と明瞭さ

却下基準

グループ方針との不整合

当グループが支持する立場や価値観と根本的に矛盾する投稿は却下されます。ただし、既存のコミュニティ出版物・ブログ記事・その他コンテンツに異論を呈する独立した見解を含むブログは歓迎します。この異論が、敬意を払い、変化に至ったデータや経験の詳細な説明を用いて提示される限り、本質的な問題とはなりません。

コミュニティ基準への不適合

コンテンツの品質、関連性、倫理的配慮においてコミュニティ基準を満たさない投稿は却下対象となります。また、コンテンツは CNCF行動規範を遵守する必要があります。

フィードバックと異議申し立て

却下された場合、投稿者にはフィードバックが提供されます。コミュニティリーダーシップチームの裁量により、再審査のための異議申し立て手続きが利用可能です。

公開プロセス

編集と最終化

ブログ投稿は、公開前に明確性、文法、フォーマットの一貫性のために軽微な編集が行われる場合があります。これはプルリクエスト（PR）のレビュー、提案、またはPRへのコミット追加を通じて行われます。

採択通知

投稿の採択は、GitHub PR承認を通じて貢献者に通知されます。

公開とプロモーション

公開された投稿は当プラットフォームで共有され、ソーシャルメディアやニュースレターを通じてプロモーションされる場合があります。公開日は承認日となりますが、著者が事前に特定の日付をリクエストし、コミュニティリーダーシップチームと合意した場合を除きます。

クロス投稿ポリシー

個人ブログや外部ブログからのコンテンツのクロス投稿を積極的に推奨・支援します。この取り組みは、コミュニティ内の多様な声や視点を広げるのに役立ちます。クロス投稿は、当プラットフォームで最初に公開するか、7暦日以内に当プラットフォームへ公開する必要があります。コミュニティプラットフォームのブログへの公開を意図する場合は、他で公開する前に公開期間の承認を得ることをお勧めします。これにより、クロス投稿へのリンクを追加できます。7日を超える場合、コミュニティ投稿はオリジナルコンテンツではないとして却下される可能性があります。

ポリシーの改訂

本ポリシーは、コミュニティの進化するニーズに継続的に適応し、コンテンツの品質と多様性に関する最高水準を維持することを目的として、グループのリーダーシップの裁量により変更される場合があります。

承諾

当プラットフォームにコンテンツを投稿することにより、投稿者（コントリビューター）は本ポリシーに定められた条件に従うことに同意したものとみなされます。

Contribute: イニシアチブとプロジェクト

Mon, 01 Jan 0001 00:00:00 +0000

イニシアチブとプロジェクト

プラットフォームエンジニアリングの実践が急速に進化する中、CNPEコミュニティはコラボレーションと知識共有の促進に取り組んでいます。貢献と参加の準備が整った複数の活発なイニシアチブとプロジェクトがあります。これらのイニシアチブは、プロダクト思考から成熟度評価まで、プラットフォームエンジニアリングの様々な側面に焦点を当てています。イニシアチブに関する情報や新規イニシアチブの提案については、イニシアチブとプロジェクトページをご覧ください。

貢献方法

開始するには、CNPEコミュニティリポジトリでWebsite Localizationイシュータイプを使用してイシューを開いてくださいこのイシュータイプは作業範囲のコンテキストを提供し、ローカライゼーション完了に必要な手順のガイダンスを提供します。

Contribute: ローカライゼーション

Mon, 01 Jan 0001 00:00:00 +0000

イントロダクション

CNCFの素晴らしさの一端は関わっている人々の多様性とコミュニティからサポートされているからです。このコミュニティをより包括的にする一例として、可能な箇所でコンテンツのローカライゼーションを提供することです。ローカライゼーションには当然それを作成およびメンテナンスする母語話者を必要とし、このページはTAG App Deliveryのコンテンツでのやり方を示します。

ガイドライン

ローカライゼーションごとに異なりますが、一般的なガイドラインやノウハウは過去のローカライゼーションのPRや Kubernetes SIG-Docsローカライゼーションドキュメントを参考にすることをおすすめします¹。

SIG-DocsチームはこのTAGに比べ、広い責任範囲を持ちます。Slackチャネルへの投稿、PRの作成、ウェブサイトのレビューなどのワークフローはその他のTAGの投稿と同一のプロセスで進められることに注意して下さい。そこに母国話者のレビューが追加されます。

SIG-Docsチームの言葉を再掲する価値があります:

Kubernetesのドキュメントすべてをローカライズするのは膨大な作業です。小さく始め、徐々に大きくしても問題ないです。

一つのホワイトペーパーから始めても、今ある言語にブログやコンテンツに追加してもよいです。どんなに些細なものでも重要で歓迎します！

貢献の仕方

始めるにはTAG App Delivery GitHubリポジトリにWebsite Translationタイプの issueの作成をしてください。

このissueタイプはあなたの仕事の範囲に関するコンテキストを提供し、ローカライゼーションを進めるのに必要な工程の手引を提供します。

訳注: 日本語へのローカライゼーションをする際には、 CNCF日本語ローカライゼーション向けガイドラインを参考にしてください。 ↩︎

Contribute: ローカライゼーション

Mon, 01 Jan 0001 00:00:00 +0000

イントロダクション

CCNCFの素晴らしさの理由の一つは、コミュニティに関わり支えられている人々の多様性です。このコミュニティをより包括的にする一つの方法は、可能な限りコンテンツのローカライゼーションを提供することです。ローカライゼーションには当然ながらネイティブスピーカーによる作成と維持が必要であり、この投稿ではCNPEコミュニティのコンテンツ内でそれを実現する方法について説明します。

プラットフォームエンジニアリングの成果物やウェブサイトは当初英語で開発されますが、他の言語に対応するための貢献を歓迎します。これはコンテンツをより広い層に届ける手助けとなり、コミュニティへの貢献にもつながる素晴らしい方法です。

ガイドライン

SIG-Docsチームの声明を改めて強調します:

Kubernetesのドキュメントすべてをローカライズするのは膨大な作業です。小さく始め、徐々に大きくしても問題ないです。

一つのホワイトペーパーから始めても、今ある言語にブログやコンテンツに追加してもよいです。どんなに些細なものでも重要で歓迎します！

貢献方法

訳注: 日本語へのローカライゼーションをする際には、 CNCF日本語ローカライゼーション向けガイドラインを参考にしてください。 ↩︎

Contribute: コミュニティへの参加

Mon, 01 Jan 0001 00:00:00 +0000

コミュニティを見つける

LinkedInで Cloud Native Platformsをフォローしてください。 CNPEコミュニティへの参加方法については、CNPEコミュニティSlackワークスペースへの参加をご検討ください。CNPEコミュニティは、プラットフォームエンジニアリングの実践者が知識を共有し、プロジェクトで協力し、互いに学び合う場です。 CNCF Slack #platform-engineering チャンネル

コミュニティ参加の形態

当コミュニティでは、技術的実践から組織的・社会技術的実践まで、あらゆる形態の活動に取り組んでいます。これらの活動は、貢献者にとって参加しやすい様々な形で実現されます。

研究調査
ホワイトペーパーおよび研究論文
ブログ記事
講演およびプレゼンテーション
ソフトウェア製品およびプロジェクト開発
コミュニティイベントおよびミートアップ
他の技術プロジェクトや組織への支援および貢献

コミュニティコンテンツの投稿方法の詳細については、ブログ記事「WG Platforms への貢献を始めるには」(/blog/contributing-to-wg-platforms/) をご覧ください。

コミュニティ参加者の種類

プラットフォームエンジニアリングは、多くの異なる実践者の役割と責任を包含する広範な分野です。CNPE コミュニティは、以下のようなあらゆるタイプのコミュニティメンバーの参加を歓迎します：

エンドユーザー
プラットフォーム管理者
サービスプロバイダー
プロジェクトメンテナ

貢献方法

まずは、CNPEコミュニティリポジトリでWebsite Localizationイシュータイプを使用してイシューを開いてくださいこのイシュータイプは、作業範囲のコンテキストを提供し、ローカライゼーションを完了するために必要な手順のガイダンスを提供します。

Contribute: プラットフォーム成熟度モデルの事例

Mon, 01 Jan 0001 00:00:00 +0000

はじめに

プラットフォームエンジニアリングは依然として発展途上の分野です。この成熟度モデルは、異なる国々、事業領域、企業規模、経験を持つ50名以上の個人によって執筆・レビューされました。とはいえ、それはあくまで執筆グループの見解を反映したものです。この貢献タイプは、その人数をさらに拡大する機会です。モデルに実例を追加し、現在のレベルに詳細な情報を付加します。

ガイドライン

この貢献タイプは、モデルの構造や文言の変更を求めていません。したがって、モデルや各側面の説明の内容、文言、さらには書式を変更するような提案は、より一般的な貢献フォーマットを通じて提出してください。本投稿の目的は、エンドユーザー（クラウドネイティブツールソリューションの実装・販売で利益を得ない企業）が成熟度モデルに関連する経験を共有することを可能にし、奨励することです。これらの事例は、具体的な実例に基づき、理想的には背景情報（例：企業規模、事業領域など）や追加情報（例：企業ブログへのリンク）で補完されることを意図しています。

投稿方法

開始するには、現行モデルを確認し、モデル詳細セクションまでスクロールしてください。このセクションには各側面ごとのページがあり、各レベルには例示シナリオセクションが設けられています（例：投資準備レベル）。

コミュニティメンバーの皆様には、現在のモデルバージョンに例を追加するプルリクエスト（PR）をオープンしていただくようお願いしています。PRは例示に限定してください。用語集、コンテンツ、成熟度モデル全体の書式変更などの変更は、別途課題として提出可能です。元の例は、読者がモデルの各側面やレベルとの関連性を実感し、モデルに自らの姿を映し出し、理想的にはモデル内の別のレベルへ移行する投資を行った場合に経験し得る事例を把握するためです。これらの事例はグループによって選定されましたが、特定の企業や正確なシナリオに帰属するものではありません。

提案する事例は、貴社の文脈においてこの特定の側面とレベルがどのように現れるかを簡潔に要約したものであるべきです。課題や成功事例を提示する場合でも、中立的な表現を用いることを推奨します。これにより「成熟度の良し悪し」ではなく「現時点における自社にとっての適切さ」というトーンが維持されます。また可能であれば企業名を明記するか、比較のための簡易な背景情報（例：「大規模な多国籍銀行」は規模・規制・領域の理解を助ける）を含めることを推奨します。現在の事例は主に200～500文字程度で、最初は難しいと感じるかもしれません。レビュー担当者が表現の洗練を支援しますので過度な心配は不要ですが、マージ前の目標となる点には留意してください。このホワイトペーパー向け事例の焦点を絞る必要がある場合、詳細を別途ブログ記事にリンクする方法も有効です。

支援依頼

この貢献形態、ご自身の具体的な状況、プルリクエスト作成の技術的な点、その他あらゆる疑問点についてご質問がある場合は、 CNCF Slackに参加の上、 #platform-engineeringまでお問い合わせください。