You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@rocketmq.apache.org by ji...@apache.org on 2022/06/29 15:19:23 UTC
[rocketmq-site] 03/03: 29how-to-contribute
This is an automated email from the ASF dual-hosted git repository.
jinrongtong pushed a commit to branch new-official-website
in repository https://gitbox.apache.org/repos/asf/rocketmq-site.git
commit 25edf6939099ebfbab51478b1ecc8ddfb10c2643
Author: liyijuan <li...@163.com>
AuthorDate: Tue Jun 28 23:16:23 2022 +0800
29how-to-contribute
---
docs/29how-to-contribute.md | 22 ++++++++++++----------
1 file changed, 12 insertions(+), 10 deletions(-)
diff --git a/docs/29how-to-contribute.md b/docs/29how-to-contribute.md
index 8edeb8fb..278c8a21 100644
--- a/docs/29how-to-contribute.md
+++ b/docs/29how-to-contribute.md
@@ -10,20 +10,22 @@ Apache RocketMQ —— 开放共享的开源社区,诚挚邀请您的加入
- 参与邮件列表上的讨论
- 贡献代码或文档
- 优化网站
-- 或测试预发布版本
+- 测试预发布版本
## 提出问题!
-Apache RocketMQ 社区提供完备的处理流程帮您解答问题。 您可以通过 [user mailing list](https://rocketmq.apache.org/about/contact/) 和 [apache-rocketmq](https://stackoverflow.com/questions/tagged/rocketmq) 进行提问
+Apache RocketMQ 社区提供完备的处理流程帮您解答问题。 您可以通过 [user mailing list](https://rocketmq.apache.org/about/contact/) 和 [apache-rocketmq](https://stackoverflow.com/questions/tagged/rocketmq) 进行提问。
## 提交错误报告
-如您在使用 RocketMQ 过程中出现问题,可以在 [Github Issue](https://github.com/apache/rocketmq/issues) 上提交错误报告
+如您在使用 RocketMQ 过程中出现问题,可以在 [Github Issue](https://github.com/apache/rocketmq/issues) 上提交错误报告。
## 提出改进或新功能
-社区在持续寻找反馈意见以改善 Apache RocketMQ 您的改进方案或新特性的需求将惠及所有 RocketMQ 用户, 请在 github 上创建 [Github Issue](https://github.com/apache/rocketmq/issues)。提案需要包含适当的细节描述和影响范围,如果可能的话详述其需求。我们希望得到尽可能完备的信息,原因如下:
+社区在持续寻找反馈意见以改善 Apache RocketMQ ,您的改进方案或新特性的需求将惠及所有 RocketMQ 用户, 请在 github 上创建 [Github Issue](https://github.com/apache/rocketmq/issues)。
+
+提案需要包含适当的细节描述和影响范围,如果可能的话详述其需求。我们希望得到尽可能完备的信息,原因如下:
* 实现的改进和新特性最终符合您的需求
* 根据您的需求评估投入成本和设计解决方案
@@ -31,13 +33,13 @@ Apache RocketMQ 社区提供完备的处理流程帮您解答问题。 您可以
若您计划实现自己的提案以贡献社区,同样需要提供详细描述信息,并遵循 [code-guidelines](/docs/30code-guidelines) 中的编码规范
-我们推荐先在社区达成共识而后着手实现功能。通过讨论新特性的必要性及实现方案等问题,可以早发现超出项目范围的提案。
+我们推荐先在社区达成共识再着手实现功能。通过讨论新特性的必要性及实现方案等问题,可以早发现超出项目范围的提案。
## 参与讨论并帮助他人
Apache RocketMQ 社区成员主要通过以下两种邮件沟通和交流:
-* [user mailing lists](mailto:users@rocketmq.apache.org) :Apache RocketMQ 用户 通过该邮件列表提问以寻求帮助或建议。您可以通过订阅该邮件系统以帮助他人解决问题来贡献社区。此外, 您还可以在 Stack Overflow 上检索 [rocketmq](https://stackoverflow.com/questions/tagged/rocketmq) tag 回答用户的问题并获取更多见解。
+* [user mailing lists](mailto:users@rocketmq.apache.org) :Apache RocketMQ 用户 通过该邮件列表提问以寻求帮助或建议。您可以通过订阅该邮件系统以帮助他人解决问题来贡献社区。此外, 您还可以在 Stack Overflow 上检索 [rocketmq](https://stackoverflow.com/questions/tagged/rocketmq) 标签 回答用户的问题并获取更多见解。
* [development mailing list](mailto:dev@rocketmq.apache.org) : Apache RocketMQ 开发者 通过该邮件列表交流新特性,预发布版本,一般的开发流程等。若您热衷于为 RocketMQ 社区贡献代码,可以加入该邮件列表。
@@ -61,18 +63,18 @@ Apache RocketMQ 已然并将持续进行维护,优化,和扩展。因此 Apa
**请务必在编码之前仔细阅读 [code-guidelines](/docs/30code-guidelines) **
-请阅读 [AFS Apache 软件基金会 贡献者协议](https://www.apache.org/licenses/contributor-agreements.html) 提交电子签名
+并请阅读 [AFS Apache 软件基金会 贡献者协议](https://www.apache.org/licenses/contributor-agreements.html) 提交电子签名
-还在四处寻找 issue ?
+万事俱备,只差 issue ?
-[Github issue](https://github.com/apache/rocketmq/issues)列出了目前已提出的改进和推荐特性。
+[Github issue](https://github.com/apache/rocketmq/issues) 列出了目前已提出的改进和推荐特性。
## 贡献文档
优秀的说明文档对任何一种软件都是至关重要的。 Apache RocketMQ 社区致力于提供简明,精准,完备的技术文档。社区诚挚邀请所有贡献参与完善和改进 RocketMQ 文档。
* 请在 [Github issue](https://github.com/apache/rocketmq/issues)上报告文档缺失,错误,过期等相关情况
-* RocketMQ 技术文档以 Markdown 形式书写,并存放在 RocketMQ [site source code repository](https://github.com/apache/rocketmq-site/tree/new-official-website/)仓库 ```/docs``` 目录下。
+* RocketMQ 技术文档以 Markdown 形式书写,并存放在 RocketMQ [site source code repository](https://github.com/apache/rocketmq-site/tree/new-official-website/)官网仓库 ```/docs``` 目录下。
阅读 [Q&A](https://github.com/apache/rocketmq-site/tree/new-official-website)了解如何通过更新和完善等方式贡献文档。