midnight2104 commented on a change in pull request #488: URL: https://github.com/apache/incubator-shenyu-website/pull/488#discussion_r830478796
########## File path: i18n/zh/docusaurus-plugin-content-docs-community/current/3-contributor.md ########## @@ -2,108 +2,107 @@ title: 贡献者指南 sidebar_position: 4 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 -``` +### 参与讨论 -**选择issue** +我们认为：[社区胜于代码](https://www.apache.org/theapacheway/index.html)。 -- 请在选择您要修改的issue。如果是您新发现的问题或想提供issue中没有的功能增强，请先新建一个issue并设置正确的标签。 -- 在选中相关的issue之后，请回复以表明您当前正在这个issue上工作。并在回复的时候为自己设置一个deadline，添加至回复内容中。 +参与讨论是贡献的第一步，请参考 [邮件订阅指南](./0-subscribe-email.md) 来订阅我们的邮件列表，并参与邮件列表上正在进行的讨论！ -**创建分支** +在讨论的过程中，请注意保持礼貌，建议阅读 ASF 的 [行为准则](https://www.apache.org/foundation/policies/conduct.html)。 -- 切换到fork的master分支，拉取最新代码，创建本次的分支。 +### 目标仓库 -```shell -git checkout master -git pull apache master -git checkout -b issueNo -``` +Apache ShenYu 一般是在 GitHub 上进行协作开发。目前有以下几个仓库： -**注意** ：PR会按照squash的方式进行merge，如果不创建新分支，本地和远程的提交记录将不能保持同步。 +[apache/incubator-shenyu](https://github.com/apache/incubator-shenyu) -**编码** +[apache/incubator-shenyu-dashboard](https://github.com/apache/incubator-shenyu-dashboard) -- 请您在开发过程中遵循 ShenYu 的 [编码建议](/community/code-suggestions)。并在准备提交pull request之前完成相应的检查。 -- 将修改的代码 push 到 fork 库的分支上。 +[apache/incubator-shenyu-website](https://github.com/apache/incubator-shenyu-website) -```shell -git add 修改代码 -git commit -m 'commit log' -git push origin issueNo -``` +[apache/incubator-shenyu-sdk](https://github.com/apache/incubator-shenyu-sdk) -**提交PR** +[apache/incubator-shenyu-nginx](https://github.com/apache/incubator-shenyu-nginx) Review comment: 可以在每个仓库加上说明，比如 主仓库，shenyu管理后台，官网等 -- 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]
