貢献方法
Apache RocketMQ —— オープンで共有されたオープンソースコミュニティ、参加を心から歓迎します。
コミュニティとのコミュニケーションと貢献の方法
- 質問をする
- エラーレポートの提出
- 新機能の紹介
- メーリングリストでの議論に参加する
- コードまたはドキュメントを貢献する
- サイトを最適化する
- プレリリース版をテストする
質問への回答のリクエスト
Apache RocketMQコミュニティは、質問に答えるための完全なプロセスを提供します。
ユーザーメーリングリストとStack Overflow #rocketmqで質問をすることができます。
エラーレポートの提出
RocketMQの使用で問題が発生した場合は、GitHub Issueにエラーレポートを提出できます。
改善または新機能の提案
コミュニティは常にApache RocketMQを改善するためのフィードバックを求めています。改善または新機能の要望は、すべてのRocketMQユーザーの利益になります。GitHub IssueでIssueを作成してください。
提案には、適切な詳細と影響範囲を含める必要があります。要件についてできるだけ詳しく説明してください。以下の理由から、より完全な情報が得られることを願っています。
- 最終的に実装される改善と新機能がニーズに適合する
- ニーズに基づいて入力コストを評価し、ソリューションを設計する
- 提案に関する建設的なコミュニティの議論を促進するため
提案を実装してコミュニティに貢献する予定がある場合は、詳細な説明情報も提供する必要があります。また、コーディング規約のコード仕様に従ってください。
機能を実装する前に、コミュニティのコンセンサスを構築することをお勧めします。新機能の必要性と実装方法について議論することで、プロジェクトの範囲外の提案を早期に特定できます。
議論に参加して他の人を助ける
Apache RocketMQコミュニティのメンバーは、次の2種類のメールを通じてコミュニケーションを取ります。
ユーザーメーリングリスト：Apache RocketMQユーザーは、メーリングリストを使用して助けやアドバイスを求めます。
メールシステムを購読して他の人が問題を解決するのを手伝うことで、コミュニティに貢献できます。
また、Stackoverflowのrocketmqタグでユーザーの質問に答え、より多くのインサイトを得ることができます。
開発メーリングリスト：Apache RocketMQ開発者は、このメーリングリストを使用して、新機能、プレリリース、一般的な開発プロセスなどを伝えます。
RocketMQコミュニティにコードを貢献することに興味がある場合は、メーリングリストに参加できます。
メーリングリストを購読して、コミュニティに関する詳細情報を取得することもできます。
プレリリース版をテストする
Apache RocketMQは、アクティブなコミュニティの助けを借りて成長を続けています。数週間ごとに、バグ修正、パフォーマンスの向上、機能の追加などを行うために、RocketMQの新バージョンをリリースします。新バージョンのリリースプロセスは次のとおりです。
- 新しいプレリリース版を公開し、投票プロセスを開始します（72時間）
- プレリリース版をテストし、スコアを付けます（+1問題なし、-1テスト問題）
- プレリリース版がテストされていない場合はリリースします。それ以外の場合は、ステップ1に戻ります
Webサイトにリリースガイドをまとめました。プレリリースのテストは大変な作業であり、より多くの人々の参加が必要です。RocketMQコミュニティは、新バージョンのテストに誰もが参加することを奨励しています。プレリリース版をテストすることで、新しいRocketMQバージョンがプログラムを適切にサービスし続け、バージョンアップをサポートしていることを確信できます。
コードの貢献
Apache RocketMQは、今後もメンテナンス、最適化、拡張が継続されます。そのため、Apache RocketMQは誰もがソースコードを貢献することを奨励しています。コード貢献者とレビュー担当者に優れたコード貢献エクスペリエンスを提供し、高品質のコードリポジトリを提供するために、コミュニティはコーディング規約の貢献プロセスに従います。コーディングマニュアルには、開発環境の構築、コミュニティのコーディングガイドラインとコーディングスタイル、および貢献コードを送信する方法に関するガイドラインが含まれています。
**コーディングを行う前に必ずコーディング規約を注意深くお読みください**
また、電子署名を提出するためにApache Software Foundationコントリビューターライセンスをお読みください。
適切なIssueを見つける方法は？
GitHub Issueには、これまでに提案された改善点と推奨機能が一覧表示されています。
ドキュメントへの貢献
優れたドキュメントは、あらゆる種類のソフトウェアにとって不可欠です。Apache RocketMQコミュニティは、簡潔で正確かつ完全な技術ドキュメントを提供することに尽力しています。コミュニティは、RocketMQドキュメントの改善と改良にご協力いただけるすべての方々を歓迎します。
- 欠落している、不正確な、期限切れのドキュメントについては、GitHub Issueで報告してください
- RocketMQの技術ドキュメントはMarkdown形式で記述されており、RocketMQ公式サイトリポジトリの
/docsに保存されています
ドキュメントを更新および改良して貢献する方法については、Q&Aをお読みください。
Webサイトを最適化する
Apache RocketMQ Webサイトは、Apache RocketMQとApache RocketMQコミュニティを表しています。その主な機能は次のとおりです。
- 訪問者がApache RocketMQとApache RocketMQの機能に精通する
- 訪問者がRocketMQをダウンロードして使用できるようにする
- 訪問者がRocketMQコミュニティに参加して貢献するようにガイドする
コミュニティは、サイトの改善に役立つあらゆる貢献を受け入れています。
サイトに関する提案やアイデアについては、Github Issueを作成して提供してください
Webサイトを更新または最適化する場合は、apache/rocketmq-site new-official-websiteをご覧ください
その他の貢献方法...
RocketMQコミュニティに貢献する方法は他にもたくさんあります
- RocketMQをできるだけ多くのパートナーに紹介する
- オフラインのコミュニケーションミーティングまたはオンラインのユーザーグループを組織する
- RocketMQのエバンジェリストになる
- ...
コミッターになるにはどうすればよいですか
コミッターは、コード、ドキュメント、Webサイトを変更したり、他のメンバーからの貢献を受け入れたりできるコミュニティのプロジェクトリポジトリのメンバーです。
コミッターになるための厳格なプロトコルはなく、候補者は通常、コミュニティで活発に貢献している人です。
活発な貢献者であるということは、メールリストでの議論に参加し、他の人が問題を解決するのを助け、プレリリース版を検証し、優れた人々を尊重し、継続的にコミュニティ管理を最適化することを意味します。これはApacheのコミュニティの一部です。
間違いなく、プロジェクトへのコードとドキュメントの貢献も同様に重要です。まず、パフォーマンスの最適化、新機能の開発、バグの修正から始めるのが良いでしょう。いずれにせよ、コードの貢献、テストケースとドキュメントの提供、および継続的なメンテナンスを担当します。
候補者は、コミュニティのコミッターまたはPMCメンバーによって推薦され、最終的にはPMCによって投票されます。
RocketMQコミュニティのコミッターになることに興味がある場合は、コミュニティに積極的に関わり、上記のいずれかの方法でApache RocketMQに貢献してください
コミュニティのコミッターメンバーは、喜んであなたと共有し、必要に応じてアドバイスとガイダンスを提供します。