跳至主要内容
版本：5.0

如何贡献

Apache RocketMQ —— 开放和共享的开源社区，诚邀您加入。

社区交流和贡献的方式

  • 提问
  • 提交错误报告
  • 介绍新功能
  • 参与邮件列表的讨论
  • 贡献代码或文档
  • 优化网站
  • 测试预发布版本

请求回答问题​

Apache RocketMQ 社区提供完整的流程来帮助您解答您的问题。

您可以通过 用户邮件列表 和 Stack Overflow #rocketmq 提问。

提交错误报告​

如果您在使用 RocketMQ 时遇到问题，您可以在 GitHub Issue 上提交错误报告。

提出改进建议或新功能​

社区一直在寻求反馈以改进 Apache RocketMQ，您对改进或新功能的需求将惠及所有 RocketMQ 用户，请在 GitHub Issue 上创建问题。

建议需要包含适当的细节和影响范围。请尽可能详细地阐述需求。我们希望获得更完整的信息，原因如下

  • 最终实现的改进和新功能符合您的需求
  • 根据您的需求评估投入成本并设计解决方案
  • 促进围绕建议的建设性社区讨论

如果您计划实施您的建议以贡献给社区，您还需要提供详细的描述信息，并遵循 代码规范 代码规范

我们建议在实施功能之前达成社区共识。通过讨论新功能的需求以及如何实施它们，可以尽早发现超出项目范围的建议。

参与讨论并帮助他人​

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 做出贡献

社区中的提交者成员将乐于与您分享，并在适当的时候为您提供建议和指导。