跳至主要內容
版本：5.0

如何貢獻

Apache RocketMQ —— 開放且共享的開源社群，誠摯邀請您加入。

社群溝通與貢獻的方式

  • 提出問題
  • 提交錯誤報告
  • 介紹新功能
  • 參與郵件清單上的討論
  • 貢獻程式碼或文件
  • 最佳化網站
  • 測試預發行版本

請求回答問題​

Apache RocketMQ 社群提供完整的流程來協助您回答問題。

您可以透過 使用者郵件清單 和 Stack Overflow #rocketmq 提出問題。

提交錯誤報告​

如果您在使用 RocketMQ 時遇到問題，您可以在 GitHub Issue 上提交錯誤報告。

提出改進或新功能​

社群持續尋求回饋以改進 Apache RocketMQ，您對改進或新功能的需求將使所有 RocketMQ 使用者受益，請在 GitHub Issue 上建立議題。

提案需要包含適當的詳細資訊和影響範圍。請盡可能詳細說明需求。我們希望獲得更完整資訊的原因如下

  • 最終實作的改進和新功能符合您的需求
  • 根據您的需求評估輸入成本和設計解決方案
  • 促進社群圍繞提案進行建設性的討論

如果您計畫實作提案以貢獻社群，您還需要提供詳細的說明資訊，並遵循 code-guidelines 程式碼規範

我們建議在實作功能前建立社群共識。透過討論新功能的需求和實作方式，可以及早發現超出專案範圍的提案。

參與討論並協助他人​

Apache RocketMQ 社群成員透過以下兩種電子郵件類型進行溝通

  • 使用者郵件清單：Apache RocketMQ 使用者使用郵件清單尋求協助或建議。

    您可以透過訂閱電子郵件系統來貢獻社群，協助他人解決問題；

    您也可以在 Stackoverflow 上檢索 rocketmq 標籤回答使用者問題並獲得更多見解。

  • 開發郵件清單：Apache RocketMQ 開發人員使用此郵件清單溝通新功能、預先發布、一般開發流程等。

    如果您有興趣為 RocketMQ 社群貢獻程式碼，您可以加入郵件清單。

您也可以透過訂閱 郵件清單 獲得更多社群資訊。

測試預發行版本​

Apache RocketMQ 在熱心社群的協助下持續成長。我們每隔幾週就會發布一個新的 RocketMQ 版本，以修正錯誤、提升效能、新增功能等。發布新版本的流程如下

  1. 發布新的預發行版本並開始投票程序 (72 小時)
  2. 測試預發行版本並評分 (+1 沒發現問題，-1 測試問題)
  3. 如果未測試預發行版本，則發布；否則，回到步驟 1

我們已在網站上編譯了發布手冊。測試預發行版本是一項大工程，我們需要更多人參與。RocketMQ 社群鼓勵所有人參與測試新版本。透過測試預發行版本，您將有信心新的 RocketMQ 版本仍能適當地為您的程式提供服務，並確實支援版本升級。

貢獻程式碼​

Apache RocketMQ 一直持續進行維護、最佳化和擴充，未來也將持續進行。因此，Apache RocketMQ 鼓勵所有人貢獻原始碼。為了讓程式碼貢獻者和審閱者有絕佳的程式碼貢獻體驗，並提供高品質的程式碼存放庫，社群遵循程式碼準則中的貢獻流程。編碼手冊包含建立開發環境、社群編碼準則和編碼風格的準則，並說明如何提交貢獻的程式碼。

**在編碼前務必仔細閱讀程式碼準則

請閱讀Apache 軟體基金會貢獻者授權以提交電子簽名。

如何找到正確的問題？

GitHub Issue列出迄今為止已提出的改進和建議功能。

貢獻文件​

良好的文件對任何軟體而言都至關重要。Apache RocketMQ 社群致力於提供簡潔、準確且完整的技術文件。社群歡迎所有貢獻，以協助完善和改進 RocketMQ 文件。

閱讀問與答，瞭解如何透過更新和改善文件來貢獻。

最佳化網站​

Apache RocketMQ 網站代表 Apache RocketMQ 和 Apache RocketMQ 社群，其主要功能如下

  • 讓訪客熟悉 Apache RocketMQ 和 Apache RocketMQ 的功能
  • 協助訪客下載和使用 RocketMQ
  • 引導訪客參與和貢獻 RocketMQ 社群

社群接受任何有助於改善網站的貢獻。

請透過建立Github Issue提供您對網站的建議和想法。

如果您想更新或最佳化網站，請參閱apache/rocketmq-site new-official-website

更多貢獻方式...​

有更多方式可以貢獻給 RocketMQ 社群，您可以選擇

  • 盡可能向許多合作夥伴介紹 RocketMQ
  • 組織線下溝通會議或線上使用者群組
  • 成為 RocketMQ 的傳教士
  • ...

如何成為提交者​

提交者是社群專案儲存庫的成員，可以修改程式碼、文件和網站，或接受其他成員的貢獻。

沒有嚴格的協定可以成為提交者，候選人通常是社群中的積極貢獻者。

成為積極貢獻者表示：參與電子郵件清單中的討論、協助其他人解決問題、驗證預發佈版本、表彰優秀人員並持續最佳化社群管理，這是 Apache 中社群的一部分。

無庸置疑，對專案貢獻程式碼和文件也同樣重要。一個好的起點是最佳化效能、開發新功能和修正錯誤。無論哪種方式，您都有責任貢獻程式碼、提供測試案例和文件，並持續維護。

候選人可由社群中的提交者或 PMC 成員推薦，並最終由 PMC 投票表決。

如果您有興趣成為 RocketMQ 社群的提交者，請積極參與社群並以任何上述方式為 Apache RocketMQ 做出貢獻

社群中的提交者成員將樂於與您分享，並適時提供建議和指導。