haibo-duan commented on a change in pull request #488: URL: https://github.com/apache/incubator-shenyu-website/pull/488#discussion_r830453705
########## File path: i18n/zh/docusaurus-plugin-content-docs-community/current/3-contributor.md ########## @@ -1,109 +1,145 @@ --- +id: contributor-guide title: 贡献者指南 -sidebar_position: 4 +sidebar_position: 3 description: Apache ShenYu 贡献者指南 -author: "xiaoyu" categories: "Apache ShenYu" tags: ["Contributor"] -date: 2019-04-09 -cover: "/img/architecture/shenyu-framework.png" --- +我们欢迎每一位贡献者的加入！ -您可以报告bug，提交一个新的功能增强建议或者直接对以上内容提交改进补丁。 +### 贡献方式 -## 提交issue +在 Apache ShenYu 社区，贡献方式有很多： -- 在提交issue之前，请经过充分的搜索，确定该issue不是通过简单的检索即可以解决的问题。 -- 查看[issue列表](https://github.com/apache/incubator-shenyu/issues)，确定该issue不是一个重复的问题。 -- [新建](https://github.com/apache/incubator-shenyu/issues/new/choose)一个issue并选择您的issue类型。 -- 使用一个清晰并有描述性的标题来定义issue。 -- 根据模板填写必要信息。 -- 在提交issue之后，对该issue分配合适的标签。如：bug，enhancement，discussion等。 -- 请对自己提交的issue保持关注，在讨论中进一步提供必要信息。 +代码：可以帮助社区完成一些任务、编写新的feature或者是修复一些bug； -## 开发流程 +测试：可以来参与测试代码的编写，包括了单元测试、集成测试、e2e测试； -**Fork分支到本地** +文档：可以编写或完善文档，来帮助用户更好地了解和使用 Apache ShenYu； -- 从 ShenYu 的repo上fork一个分支到您自己的repo来开始工作，并设置upstream为 ShenYu 的repo。 +博客：可以撰写 Apache ShenYu 的相关文章，来帮助社区更好地推广； -* 从你的github仓库克隆代码. +讨论：可以参与 Apache ShenYu 新的feature的讨论，将你的想法跟 Apache ShenYu 融合； -```shell -git clone https://github.com/your-github/incubator-shenyu.git -``` +建议：也可以对项目或者社区提出一些建议，促进社区的良性发展； -Windows 环境下，如果克隆 Apache Shenyu 源码时，提示文件名过长，请参看[FAQ](/community/faq) +。。。 -* 设置远程仓库 (为了同步代码) . +即便是小到错别字的修正，或者是对404链接的修正，我们也都非常欢迎 :) -```shell -git remote add apache https://github.com/apache/incubator-shenyu.git -``` +### 参与讨论 + +我们认为：[社区胜于代码](https://www.apache.org/theapacheway/index.html)。 + +参与讨论是贡献的第一步，请先订阅我们的邮件列表，并参与邮件列表上正在进行的讨论！ + +订阅邮件的步骤很简单： + +1. 向 [[email protected]](mailto:[email protected]) 发送一封邮件； +2. 发送成功后，你会收到来自 [[email protected]](mailto:[email protected]) 的回信，请按照邮件的提示回复这封邮件，确认订阅； +3. 在回复确认后，你会收到一封欢迎邮件，表示你已经成功订阅了邮件。 + +在订阅成功后，你就可以在 [[email protected]](mailto:[email protected]) 参与讨论了。你也可以点击 [公共归档](https://lists.apache.org/[email protected]) 来看到历史邮件。 + +在讨论过程中，请保持礼貌，建议阅读 ASF 的 [行为准则](https://www.apache.org/foundation/policies/conduct.html)。 + +### 目标仓库 + +Apache ShenYu 一般是在 GitHub 上进行协作开发。目前有以下几个仓库： + +[apache/incubator-shenyu](https://github.com/apache/incubator-shenyu) + +[apache/incubator-shenyu-dashboard](https://github.com/apache/incubator-shenyu-dashboard) + +[apache/incubator-shenyu-website](https://github.com/apache/incubator-shenyu-website) + +[apache/incubator-shenyu-sdk](https://github.com/apache/incubator-shenyu-sdk) + +[apache/incubator-shenyu-nginx](https://github.com/apache/incubator-shenyu-nginx) + +### 让 Apache ShenYu 运行起来 -**选择issue** +让 Apache ShenYu 的代码在你的开发工具上运行起来，请参阅 [本地部署](../docs/next/deployment/deployment-local) 或者 [Apache ShenYu 启动示例](../blog/Start-SourceCode-Analysis-Start-Demo)，并且能够断点调试。 -- 请在选择您要修改的issue。如果是您新发现的问题或想提供issue中没有的功能增强，请先新建一个issue并设置正确的标签。 -- 在选中相关的issue之后，请回复以表明您当前正在这个issue上工作。并在回复的时候为自己设置一个deadline，添加至回复内容中。 +在运行起来之后，可以阅读我们官网收录的[源码分析文章](../blog)，来对 Apache ShenYu 有更深入的理解。 -**创建分支** +### 寻找任务 -- 切换到fork的master分支，拉取最新代码，创建本次的分支。 +寻找你感兴趣的Issue！在我们的GitHub仓库和邮件列表中，我们经常会发布一些带有 `good first issue` 或者 `status: volunteer wanted` 标签的issue，这些issue都欢迎贡献者的帮助。其中good first issue往往门槛较低、适合新手，你可以点击 [链接](https://github.com/apache/incubator-shenyu/issues?q=is%3Aopen+is%3Aissue+label%3A%22good+first+issue%22%2C%22status%3A+volunteer+wanted%22) 查看这些issue。 + +当然，如果你有好的想法，也可以直接在邮件列表中提出，经过充分讨论后就可以开始行动。 + +同时，你也可以参与编写我们的源码分析文章，并通过 Pull Request 的方式提交到 Apache ShenYu 官网的博客模块。 + +如果你是学生，那么也非常欢迎在 GSoC 等开源实习活动中申请 Apache ShenYu 的议题，你可以点击 [链接](https://community.apache.org/gsoc.html) 来查看 Apache 软件基金会对 GSoC 的介绍。你也可以通过这个 [链接](https://github.com/apache/incubator-shenyu/issues?q=is%3Aopen+is%3Aissue+label%3Agsoc) 来查看 Apache ShenYu 往年或者正在进行中的 GSoC 议题！ + +### 提交Pull Request + +首先你需要 Fork 你的目标仓库。 Review comment: 首先，您需要Fork 目标仓库。 -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: [email protected] For queries about this service, please contact Infrastructure at: [email protected]
