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:20 UTC
[rocketmq-site] branch new-official-website updated (b4aba3e6 -> 25edf693)
This is an automated email from the ASF dual-hosted git repository.
jinrongtong pushed a change to branch new-official-website
in repository https://gitbox.apache.org/repos/asf/rocketmq-site.git
from b4aba3e6 Init new website
new 55008d79 29how-to-contribute
new dd50984f 29how-to-contribute
new 25edf693 29how-to-contribute
The 3 revisions listed above as "new" are entirely new to this
repository and will be described in separate emails. The revisions
listed as "add" were already present in the repository and have only
been added to this reference.
Summary of changes:
docs/29how-to-contribute.md | 117 ++++++++++++++++++++++++++++++++++++++++++++
1 file changed, 117 insertions(+)
[rocketmq-site] 02/03: 29how-to-contribute
Posted by ji...@apache.org.
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 dd50984fe2ae1b2aeb670e36d285b26eb174e9a3
Author: liyijuan <li...@163.com>
AuthorDate: Tue Jun 28 23:07:11 2022 +0800
29how-to-contribute
---
docs/29how-to-contribute.md | 44 ++++++++++++++++++--------------------------
1 file changed, 18 insertions(+), 26 deletions(-)
diff --git a/docs/29how-to-contribute.md b/docs/29how-to-contribute.md
index d7d5617b..8edeb8fb 100644
--- a/docs/29how-to-contribute.md
+++ b/docs/29how-to-contribute.md
@@ -1,10 +1,6 @@
----
-title: "贡献指南"
-permalink: /docs/how-to-contribute/
-modified: 2022-6-28T21:15:00-20:00
----
+# how-to-contribute
-Apache RocketMQ —— 开放共享的开源社区，诚挚邀请您的加入。
+Apache RocketMQ —— 开放共享的开源社区，诚挚邀请您的加入
社区交流和贡献方式：
@@ -14,12 +10,12 @@ 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) 进行提问
## 提交错误报告
@@ -33,30 +29,30 @@ Apache RocketMQ 随时待命，致力于解决您的问题。 您可以通过 [u
* 根据您的需求评估投入成本和设计解决方案
* 便于社区围绕该提案展开建设性的讨论
-若您计划实现自己的提案以贡献社区，同样需要提供详细描述信息，并遵循 [code-guidelines](/docs/30code-guidelines) 中的编码规范
+若您计划实现自己的提案以贡献社区，同样需要提供详细描述信息，并遵循 [code-guidelines](/docs/30code-guidelines) 中的编码规范
-我们推荐先在社区达成共识而后再着手实现功能。通过讨论新特性的必要性及实现方案等问题，可以早发现超出项目范围的提案。
+我们推荐先在社区达成共识而后着手实现功能。通过讨论新特性的必要性及实现方案等问题，可以早发现超出项目范围的提案。
## 参与讨论并帮助他人
-Apache RocketMQ 社区成员主要通过以下两种邮件沟通和交流:
+Apache RocketMQ 社区成员主要通过以下两种邮件沟通和交流：
* [user mailing lists](mailto:users@rocketmq.apache.org) ：Apache RocketMQ 用户 通过该邮件列表提问以寻求帮助或建议。您可以通过订阅该邮件系统以帮助他人解决问题来贡献社区。此外, 您还可以在 Stack Overflow 上检索 [rocketmq](https://stackoverflow.com/questions/tagged/rocketmq) tag 回答用户的问题并获取更多见解。
-* [development mailing list](mailto:dev@rocketmq.apache.org) : Apache RocketMQ 开发者 通过该邮件列表交流新特性，即将发布的版本，一般的开发流程等。若您热衷于为 RocketMQ 社区贡献代码，可以加入该邮件列表。
+* [development mailing list](mailto:dev@rocketmq.apache.org) : Apache RocketMQ 开发者 通过该邮件列表交流新特性，预发布版本，一般的开发流程等。若您热衷于为 RocketMQ 社区贡献代码，可以加入该邮件列表。
您也可以通过订阅 [mailing lists](/about/contact)，获取更多的社区信息。
-## 测试候选版本
+## 测试预发布版本
Apache RocketMQ 在其活跃社区的推动下持续发展着。每隔几周我们会发布 RocketMQ 的新版本，以修复漏洞，提升性能，新增特性等。发布新版本的流程如下：
-1. 推出新的候选版本并启动投票流程（时效 72 小时）
-2. 测试候选版本并评分 (+1 未发现问题, -1 测试出问题)
-3. 若候选版本未测试出问题则发布，否则回到步骤 1
+1. 推出新的预发布版本并启动投票流程（时效 72 小时）
+2. 测试预发布版本并评分 (+1 未发现问题, -1 测试出问题)
+3. 若预发布版本未测试出问题则发布，否则回到步骤 1
-我们在网站上整理了 [release-manual](/docs/32release-manual)版本发布指针。测试发行版是项大工程，我们需要吸纳更多人的参与。 RocketMQ 社区鼓励每个人都参与新版本的测试。通过测试候选版本, 您将确信新的 RocketMQ 版本仍将为您的程序提供正常服务，并确实在支持版本升级。
+我们在网站上整理了 [release-manual](/docs/32release-manual) 版本发布指南。测试预发行版是项大工程，我们需要吸纳更多人的参与。 RocketMQ 社区鼓励每个人都参与新版本的测试。通过测试预发布版本, 您将确信新的 RocketMQ 版本仍将为您的程序提供正常服务，并确实在支持版本升级。
## 贡献代码
@@ -76,7 +72,7 @@ Apache RocketMQ 已然并将持续进行维护，优化，和扩展。因此 Apa
优秀的说明文档对任何一种软件都是至关重要的。 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)了解如何通过更新和完善等方式贡献文档。
@@ -109,16 +105,12 @@ Committers 是社区中修改项目仓库的成员，可修改代码，文档和
成为 commiter 并没有严格的协议，候选人通常是社区中活跃的贡献者
-活跃的贡献者意味着：参加邮箱列表中的讨论，帮助他人解决问题，验证候选版本，礼贤下士并精英化社区管理，这部分关乎社区在 Apache 中的发展。
+活跃的贡献者意味着：参加邮箱列表中的讨论，帮助他人解决问题，验证预发布版本，礼贤下士并持续优化社区管理，这部分关乎社区在 Apache 中的发展。
-无疑，为项目贡献代码和文档同样至关重要。好的开端可以是优化性能，开发新特性，修复漏洞。无论哪种方式您需要为所贡献的代码负责，提供测试用例和说明文档并持续维护。
+无疑，为项目贡献代码和文档同样至关重要。好的开端可以是优化性能，开发新特性，修复漏洞。无论哪种方式，您需要为所贡献的代码负责，提供测试用例和说明文档并持续维护。
候选人可以被社区内的 committer 或 PMC 成员举荐，并最终由 PMC 投票表决。
-如您有意成为 RocketMQ 社区的 committer ，请积极融入社区并以上述任意方式贡献 Apache RocketMQ ，社区的 committer 成员会非常热衷与您分享交流并给予您适时的建议和指导。
+如您有意成为 RocketMQ 社区的 committer ，请积极融入社区并以上述任意方式贡献 Apache RocketMQ
-## 参考
-
-本文参考自 Apcahe Flink 贡献指南[1].
-
-[1]. [Apache Flink: How To Contribute](https://flink.apache.org/contributing/how-to-contribute.html)
\ No newline at end of file
+社区内 committer 成员会非常热衷与您分享交流，并给予您适时的建议和指导。
\ No newline at end of file
[rocketmq-site] 01/03: 29how-to-contribute
Posted by ji...@apache.org.
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 55008d797d412f139cb373673f3f23ea60d8111d
Author: liyijuan <li...@163.com>
AuthorDate: Tue Jun 28 21:20:16 2022 +0800
29how-to-contribute
---
docs/29how-to-contribute.md | 125 +++++++++++++++++++++++++++++++++++++++++++-
1 file changed, 124 insertions(+), 1 deletion(-)
diff --git a/docs/29how-to-contribute.md b/docs/29how-to-contribute.md
index 0a2ce3f2..d7d5617b 100644
--- a/docs/29how-to-contribute.md
+++ b/docs/29how-to-contribute.md
@@ -1 +1,124 @@
-# how-to-contribute
+---
+title: "贡献指南"
+permalink: /docs/how-to-contribute/
+modified: 2022-6-28T21:15:00-20:00
+---
+
+Apache 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) 上提交错误报告
+
+## 提出改进或新功能
+
+社区在持续寻找反馈意见以改善 Apache RocketMQ 您的改进方案或新特性的需求将惠及所有 RocketMQ 用户, 请在 github 上创建 [Github Issue](https://github.com/apache/rocketmq/issues)。提案需要包含适当的细节描述和影响范围，如果可能的话详述其需求。我们希望得到尽可能完备的信息，原因如下：
+
+* 实现的改进和新特性最终符合您的需求
+* 根据您的需求评估投入成本和设计解决方案
+* 便于社区围绕该提案展开建设性的讨论
+
+若您计划实现自己的提案以贡献社区，同样需要提供详细描述信息，并遵循 [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 回答用户的问题并获取更多见解。
+* [development mailing list](mailto:dev@rocketmq.apache.org) : Apache RocketMQ 开发者 通过该邮件列表交流新特性，即将发布的版本，一般的开发流程等。若您热衷于为 RocketMQ 社区贡献代码，可以加入该邮件列表。
+
+
+您也可以通过订阅 [mailing lists](/about/contact)，获取更多的社区信息。
+
+
+## 测试候选版本
+
+Apache RocketMQ 在其活跃社区的推动下持续发展着。每隔几周我们会发布 RocketMQ 的新版本，以修复漏洞，提升性能，新增特性等。发布新版本的流程如下：
+
+1. 推出新的候选版本并启动投票流程（时效 72 小时）
+2. 测试候选版本并评分 (+1 未发现问题, -1 测试出问题)
+3. 若候选版本未测试出问题则发布，否则回到步骤 1
+
+我们在网站上整理了 [release-manual](/docs/32release-manual)版本发布指针。测试发行版是项大工程，我们需要吸纳更多人的参与。 RocketMQ 社区鼓励每个人都参与新版本的测试。通过测试候选版本, 您将确信新的 RocketMQ 版本仍将为您的程序提供正常服务，并确实在支持版本升级。
+
+## 贡献代码
+
+Apache RocketMQ 已然并将持续进行维护，优化，和扩展。因此 Apache RocketMQ 鼓励所有人贡献源代码。为给予代码贡献者和审查者极佳的代码贡献体验，并提供高质量的代码仓库，社区遵循 [code-guidelines](/docs/30code-guidelines) 中的贡献流程。编码手册包含构建开发环境指南，社区编码指南和编码风格，并介绍了如何提交贡献的代码。
+
+
+**请务必在编码之前仔细阅读 [code-guidelines](/docs/30code-guidelines) **
+
+请阅读 [AFS Apache 软件基金会 贡献者协议](https://www.apache.org/licenses/contributor-agreements.html) 提交电子签名
+
+还在四处寻找 issue ？
+
+[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``` 目录下。
+
+阅读 [Q&A](https://github.com/apache/rocketmq-site/tree/new-official-website)了解如何通过更新和完善等方式贡献文档。
+
+## 优化官网
+
+Apache RocketMQ 官网代表着 Apache RocketMQ 和 Apache RocketMQ 社区。其主要功能如下：
+
+* 通晓访问者 Apache RocketMQ 和 Apache RocketMQ 的功能特性
+* 支持访问者 下载并使用 RocketMQ
+* 引导访问者 参与并贡献 RocketMQ 社区
+
+社区接纳任何有助于优化网站的贡献。
+
+请通过创建 [Github issue](https://github.com/apache/rocketmq-site/issues) 提供您关于网站的建议和创意
+
+如您想要更新或优化网站，请阅读[apache/rocketmq-site: Mirror of RocketMQ site](https://github.com/apache/rocketmq-site)
+
+## 更多贡献途径...
+
+条条大路通罗马，还有更多贡献 RocketMQ 社区的方式等您选择！ 例如您可以：
+
+* 介绍 RocketMQ 给尽可能多的伙伴使用
+* 组织线下交流会或组建线上用户群
+* 化身 RocketMQ 的布道师
+* ...
+
+## 如何成为 committer
+
+Committers 是社区中修改项目仓库的成员，可修改代码，文档和网站或接纳其他成员的贡献。
+
+成为 commiter 并没有严格的协议，候选人通常是社区中活跃的贡献者
+
+活跃的贡献者意味着：参加邮箱列表中的讨论，帮助他人解决问题，验证候选版本，礼贤下士并精英化社区管理，这部分关乎社区在 Apache 中的发展。
+
+无疑，为项目贡献代码和文档同样至关重要。好的开端可以是优化性能，开发新特性，修复漏洞。无论哪种方式您需要为所贡献的代码负责，提供测试用例和说明文档并持续维护。
+
+候选人可以被社区内的 committer 或 PMC 成员举荐，并最终由 PMC 投票表决。
+
+如您有意成为 RocketMQ 社区的 committer ，请积极融入社区并以上述任意方式贡献 Apache RocketMQ ，社区的 committer 成员会非常热衷与您分享交流并给予您适时的建议和指导。
+
+## 参考
+
+本文参考自 Apcahe Flink 贡献指南[1].
+
+[1]. [Apache Flink: How To Contribute](https://flink.apache.org/contributing/how-to-contribute.html)
\ No newline at end of file
[rocketmq-site] 03/03: 29how-to-contribute
Posted by ji...@apache.org.
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)了解如何通过更新和完善等方式贡献文档。