FinOps ツールキットの投稿ガイド

FinOps ツールキットへようこそ。 オープンソースのイニシアチブとして、私たちの成功はコミュニティの集合的な努力にかかっています。 あなたの貢献は、ツールキットの機能を強化および拡張する上で重要な役割を果たし、すべての人にとってより価値があり、効果的になります。

FinOps ツールキットに貢献するには、いくつかの方法があります。

  • 既存のバグに取り組む: リポジトリに記載されている既存のバグを特定して対処することで支援できます。
  • 新機能や機能改善に関する提案をする: コーディングに慣れていない場合でも、ツールの新機能や改善点を提案することで貢献できます。
  • 新しいツールの提案: FinOps 関連のツールを開発し、それを FinOps ツールキットの一部にしたい場合は、検討のための提案を送信できます。
  • pull requests のレビュー: コード レビューは、コードの品質を維持し、プロジェクトの信頼性と機能を確保するうえで重要な側面です。 コミュニティ メンバーから提案された既存のプル要求 (PR) を確認することで、必ずしも新しいコードを作成することなく、プロジェクトの成功に大きく貢献できます。
  • 質問に答える: 積極的に質問に答え、コミュニティメンバーに支援を提供することは、プロジェクトに対する貴重な貢献です。
  • ドキュメントの更新: ドキュメントは、ユーザー、開発者、共同作成者にとって重要なリソースとして機能します。 Microsoft は、ドキュメントを正確かつ包括的かつ最新の状態に保つように努めています。 ツールキットの成功には不可欠です。

FinOps ツールキットへの貢献にご関心をお寄せください。

チームとつながりを維持したいですか? 毎週の共同作成者の同期は、水曜日の午前8時(太平洋時間)/ 午後4時(UTC)に参加するか、隔週のオフィスアワーには午前8時30分(太平洋時間)/ 午後4時30分(UTC)に参加します。


既存のバグに対する作業

投稿したいが、どこから始めればいいのか分からない場合は、既存のフィードバックの一覧を確認するのが良い出発点です。 次に、スキルと興味に合った問題を特定します。

  1. 既存の問題の一覧 確認
  2. 作業するバグに自分自身を割り当てます。

この記事を初めて読み、FinOps ツールキット リポジトリで作業している場合は、 Get started wiki を確認してください。


貢献する方法

FinOps ツールキット プロジェクトには、開発者、FinOps 実務者、クラウド愛好家など、さまざまな方法で貢献できます。 以下のセクションでは、参加する方法について説明します。

新しい問題を送信する

新しい機能の提案がある場合、バグを特定した場合、または既存のツールを改善するためのアイデアがある場合は、問題を送信することをお勧めします。 お客様のフィードバックは、ツールキットがユーザーのニーズを満たしていることを確認するのに役立ちます。 さらに一歩踏み込んで提案の実装に貢献したい場合は、投稿をお待ちしております。

これを行うには、次の手順を実行します。

  1. issues リストに移動し新しい問題を選択します。
  2. 投稿内容 (バグ修正、変更要求、または機能要求) を最も適切に説明するオプションを選択します。
  3. ページの下部にある [ 修正する を選択します。
  4. 問題を送信します。

新しいツールを提案する

FinOps 関連のツールを開発し、FinOps ツールキットの一部にする場合は、問題の一覧に移動し、 新しい問題を選択し、 新しいツールのプロパティ オプションを選択します。 ツールに関する情報と、それが FinOps コミュニティにどのように役立つのかについて、できるだけ多くの情報を含めます。

FinOps ツールキットの管理委員会は、提案をレビューし、さらに議論するために連絡します。


pull request をレビューする

オープン pull request の一覧を確認しコミュニティ メンバーによって提案されたコード変更に関する建設的なフィードバックを提供します。 コードが コーディングガイドラインに準拠していることを確認、適切に文書化され、ベスト プラクティスに従っていることを確認します。

パフォーマンスの最適化、読みやすさの向上、潜在的なエッジ ケースやバグへの対処など、コードの品質を向上させる提案を提供します。

それらが意図したとおりに動作することを確認するには、PR で提案されたコード変更の機能をテストします。 テストの実行、エッジ ケースの検証、意図しない副作用のチェックが含まれます。

可能な場合は、 提案の追加 を使用してコードの変更を提案して、レビュー プロセスを効率化してみてください。

プルリクエストレビューのスクリーンショット、「提案の追加」オプション。


質問に答える

質問に積極的に取り組み、コミュニティメンバーに支援を提供することは、プロジェクトに対する貴重な貢献です。

  • 知識を共有する: あなたの専門知識と経験を利用して、コミュニティメンバーによって提起された質問に役立つ有益で有益な回答を提供します。 回答をサポートするための明確な説明、例、および参照を提供します。
  • 問題の解決に役立つ: コミュニティ メンバーが技術的な問題のトラブルシューティングを行ったり、ツールキットの使用中に発生した構成の問題を解決したりする際に支援します。

ドキュメントを更新する

  • 改善の領域を特定する: 既存のドキュメントを確認して、対処する必要がある古い情報、不正確さ、またはギャップを特定します。
  • 明確さと一貫性の向上: あいまいなセクションを明確にし、構造を改善するためにコンテンツを再構成し、ドキュメント全体で用語、書式設定、スタイルの一貫性を確保します。
  • コンテンツの更新: 古い情報を更新し、最近の機能や変更に対応する新しいコンテンツを追加し、関連しなくなった古いセクションを削除します。

今後ともよろしくお願いいたします。

大小をオープンソースに貢献すると、このようなプロジェクトが可能になります。 ご協力いただき、ありがとうございます。


Microsoft オープン ソース倫理規定

このプロジェクトでは、 Microsoft オープン ソース行動規範を採用しました。

詳しくは、倫理規定についてよくある質問に関する記事を参照するか、opencode@microsoft.com 宛てに質問またはコメントをお送りください。