From 6e2c3b4cadfe9a1f69cd092a1fac9c000382a09a Mon Sep 17 00:00:00 2001 From: blueskycs2c Date: Tue, 3 Mar 2020 14:52:22 +0800 Subject: [PATCH] Translate the contents of community-membership into English --- Governance.md | 4 +- community-membership.md | 161 +++++++++++++++++-------------------- community-membership_cn.md | 120 +++++++++++++++++++++++++++ zh/contributors/README.md | 2 +- 4 files changed, 196 insertions(+), 91 deletions(-) create mode 100644 community-membership_cn.md diff --git a/Governance.md b/Governance.md index 11df47451..7ec303dc9 100644 --- a/Governance.md +++ b/Governance.md @@ -20,7 +20,7 @@ openEuler社区遵循[社区行为准则](code-of-conduct.md) ## 社区成员 -请查看[社区成员](community-membership.md) +请查看[社区成员](community-membership_cn.md) @@ -79,7 +79,7 @@ SIG会针对一个或多个主题树立目标，从而成立项目去实现目 SIG是在公开场合运作的自愿团体，任何人都可以加入。但因为某些领域需要谨慎处理（例如安全性），所以委员会不公开成员资格，而且并不总是公开运作。 - 技术委员会可以根据需要，在有限的时间内成立某一特定委员会。委员会的成员资格由技术委员会决定，但所有委员会成员必须是[社区成员](community-membership.md)。与项目一样，委员会也有章程，并定期向社区和技术委员会报告。 + 技术委员会可以根据需要，在有限的时间内成立某一特定委员会。委员会的成员资格由技术委员会决定，但所有委员会成员必须是[社区成员](community-membership_cn.md)。与项目一样，委员会也有章程，并定期向社区和技术委员会报告。 [Committee文件夹](committee/)内记录了openEuler社区当前的所有的委员会。 diff --git a/community-membership.md b/community-membership.md index 91c547bd8..5882f8bcb 100644 --- a/community-membership.md +++ b/community-membership.md @@ -1,120 +1,105 @@ -# 社区成员 +# Community Member -本文简要描述了openEuler社区中贡献者角色的各种职责。大部分角色的职责限于这些SIG(Special Interest Group)内： - -|角色| 职责范围（简要描述）|要求|定义的文件| +This article briefly describes the responsibilities and privilege of the contributor in the openEuler community. The responsibilities of most contributor are limited to SIG (Special Interest groups) : +|Role| Responsibilities |Requirement|Defined Document| |:-----------|:-------------------- |:----------------------------------------------------- |:----------------------------------------------------------- | -|Contributor|项目的贡献者|| Gitee注册成员| -|Committer| 审核其他成员的贡献| SIG的积极贡献者，经验丰富，愿意投入精力参与到审核工作 | openEuler SIG拥有的存储库中OWNERS文件中的*Maintainer*条目。 | -| Maintainer| 项目Owner| 经验丰富，富有责任心、出色的技术能力和管理能力| openEuler SIG拥有的存储库中OWNERS文件中的*Maintainer*条目。 | - -*说明*：Maintainer和Committer在Gitee的权限上不做区分，两者的区分主要是集中在SIG治理的管理范围上。详细可以见下面的描述。 - - - -## 新的贡献者 - -欢迎新成员加入社区。我们有关于如何开始贡献的指导文档请参考：[openEuler贡献者指南](/zh/contributors/README.md) - - - -## 既有社区成员 - - -既有的社区成员应证明能够遵守本文中的原则，熟悉SIG的组织、角色、政策、软件、约定等，以及相关的技术和/或写作能力。社区成员角色的期望、职责和要求，请参考下面的内容。 - - - -## 贡献者 Contributor -贡献者是社区中持续活跃的贡献者，他们可以认领问题和PR，可以参与SIG组活动，并且可以为PR提交前完成测试。 - - - -### 要求 +|Contributor|Contributors of the project|| Registered members on Gitee| +|Committer| Review and approve the contributions submitted| Frequently contributing to SIG, experienced,and willing to undertake review work | *developer* entry in the OWNERS file owned by openEuler SIG| +| Maintainer| Owner of the project| Experienced, responsible, outstanding technologies and management skills| *developer* entry in the OWNERS file owned by openEuler SIG | -+ Gitee上的注册会员 -+ 为SIG或社区做出多方面贡献，包括不限于： - + 在Gitee上提交或审核PR - + 在Gitee上对问题进行归档或评论 - + 参与SIG或社区讨论 -+ 已阅读[贡献者指南](/zh/contributors/README.md) -+ 积极参与1个或多个SIG +*Description*：The permissions of Maintainer and Committer are the same on Gitee, and the difference lies in the scope of SIG governance. The detailed informationes are described below. + +## New Contributor +Welcome to join the community. Start contributing by referring to [contribution guidience](/en/contributors/README.md). -### 责任与权利 +## Existing Community Member -+ 响应被分配的问题和PR -+ 贡献的代码应该 - + 经过良好的测试 - + 能够让测试用例始终通过 - + 解决后继发生的错误或问题 -+ 可以通过 `/lgtm`打开PR -+ 可以分配问题或PR，可以通过 `/cc @username`要求成员进行评论 -+ 可以针对PR自动运行测试。`/ok-to-test`不是必要的 -+ 可以使用`/ok-to-test`为具有`needs-ok-to-test`标签的PR进行操作，并使用诸如`/close`对PR进行关闭。 +Existing community members should follow the principles in this article and be familiar with SIG's organization, roles, policies, software, and etc. At the same time, they should have corresponding technical and writing skills. The detailed informatione of responsibilities and requirements of the community member are described below. -**注意**：经常贡献代码的成员应积极的参与代码审查，并努力成为SIG的*审核者Committer*。 +## Contributor +Contributors are people who frequently contribute to the community. They take part in SIG group activities, resolve questions, review PR, and complete tests before submitting the PR. -## 审核者 Committer +### Requirement -审核者能够在SIG或SIG的某些部分中审核代码的质量和正确性。审核者对代码库和软件工程原理非常了解。 ++ Registered member on Gitee ++ Contribute to SIG or community in many ways, including but not limited to: + + Submitting or reviewing PR(Pull Request) on Gitee + + Documenting or commenting issues on Gitee + + Participating in SIG or community discussions ++ Read [Contribution Guideline](/en/contributors/README.md) ++ Join one or more SIGs -定义者：openEuler SIG拥有的存储库中OWNERS文件中的*developer*条目。 +### Responsibility and Power -### 要求 ++ Respond to assigned issues and PR(Pull Request) ++ Contributed code should satisfy the criteria described below + + Well tested + + Passing the test correctly and completely + + Resolving subsequent errors or problems ++ Agree PR by executing '/ lgtm' ++ Assign issue or PR, ask memebers to comment by execting`/assign @username` ++ Run PR test automatically. `/ok-to-test` is not necessary ++ Operate the PR with `needs-ok-to-test` label by execting `/ok-to-test` and close PR by execting `/close`. -+ 作为贡献者至少3个月 -+ 作为主要审阅者至少参与了6次PR的审阅 -+ 审阅或合并至少20个基本PR到代码库 -+ 熟悉代码库 -+ 可以自我提名，或由该SIG的审核者或维护者提名 +**Note**: Contributors should actively take part in code review and if they'd like to help more, strive to be a *Committer* of SIG. -### 责任与权力 +## Committer -+ **评审PR**：对Contributor提交的PR完成评审，评审可以参考社区的[编程建议]()和[安全编程规范]()。 -+ **分发处理问题**，请参考“[问题处理流程]()“。 -+ **跟踪依赖性问题**：在开发分支中，其他SIG组的软件包的更新可能会到导致破坏本SIG内软件包的依赖关系。此时Committer会收到告警提示，Committer应尽力重建软件包。依赖关系出错可能会使最终用户无法更新系统，打包团队也会介入并重建存在依赖性问题的软件包，但Maintainer不应依赖这些重建。 -+ **如有接口变更，通知可能会影响到的SIG**：其他SIG或项目会依赖本SIG的软件包，对软件包接口的变更可能会对他们造成影响。Maintainer应了解并评审&决策变更造成的依赖影响，并公告和发送API或ABI变更的告警邮件。这类公告应在变更发生至少一周前完成，并应通知到所有可能受影响的SIG。具体请参考[接口变更通知流程]()。 -+ **更新和维护软件包版本**：遵守社区的[软件包更新质量控制策略]()完成软件包的更新。 -+ **和上游社区合作**，包括： - + 将所有变更推送到上游社区 - + 参与上游社区邮件列表 - + 获取上游社区的bug跟踪器的账户，并跟踪上游社区的重要bug - + 将严重的错误转发给上游社区以寻求帮助 - 更多信息，请参考“[上游社区软件包管理建议]()” -+ **和测试团队合作**，包括： - + 在提交软件包时，向质量检查人员提供如何调试/分类软件包的信息，以供问题的分类 - + 提供基本功能的测试用例，用于测试回归 - + 提交软件包更新时，提供有关更新中已经修复问题的测试用例，以供质量检查人员使用。 +Committers can review the quality and correctness of code in SIG or some parts of SIG. Committers should have a good knowledge of code repository and software engineering principles. +**Definition**：*developer* entry in the OWNERS file owned by each SIG. +### Requirement -## 维护者 Maintainer ++ Have worked in openEuler for At least 3 months as contributors ++ Participated in at least 6 PR reviews as the main reviewer ++ Review or merge at least 30 PR into the code repo ++ Being Familiar with code repo ++ Can be self-nominated or nominated by the committers or maintainer of the SIG -维护者是SIG组的组长或者管理委员会成员，也是软件包的维护者，能够像Committer一样审查和批准代码贡献。代码审查的重点是代码质量和正确性，而批准的重点是对贡献的整体接受度。**所有Committer的责任与权力，Maintainer均具有**。除此之外，Maintainer还承担了团队的技术路线、内外协调等工作。 +### Responsibility and Privilege -**定义**：openEuler SIG拥有的存储库中OWNERS文件中的*developer*条目 ++ **Review PR**：Review the PR submitted by contributor. The review can refer to [编程建议]() and [安全编程规范](). ++ **Distribute and deal with problems**:Please refer to [问题处理流程]() . ++ **Tracking dependency issues**：In the development branch, software package's dependencies in the SIG may be broken due to the software package updates in other SIG. At this time, the Committer will receive an alert. Then, the committer should try to rebuild the software package. Because dependency problem may prevent users from updating the system, the build team will also participates in rebuilding packages that have dependency issues, but the Maintainer should not rely on these works. ++ **Notify SIG that may be affected due to interface changes**：Because other SIGs or projects rely on software package of this SIG, changes to the package interface may affect them. Maintainer should review the dependency impact caused by decision changes. Then Maintainer should announce and send alert emails of API or ABI changes. +Those work should be completed at least one week before the change occurs, and all SIGs that may be affected should be notified. For detailed informationes please refer to [接口变更通知流程](). ++ **Update and maintain package version**：Follow the startegy of [软件包更新质量控制策略]() and complete the package update. ++ **Collaborate with upstream community**, including: + + Push all changes to upstream community + + Participate in upstream community mailing list + + Get the account of the Bug Tracker of the upstream community, and track the important bugs of the upstream community + + Push serious errors to upstream community for help + For further information, please refer to [上游社区软件包管理建议]() ++ **Collaborate with test team** including: + + When you submit the software packages, the information how to debug and classify the packages should be provided to QA for problem classification + + Provide basic functional test cases for regression testing + + When you update the software package, the test cases related to fixed problems in the update package should be provided to QA +## Maintainer -### 要求 +Maintainer is the leader of SIG group or member of management Committee, and also the maintainer of software package. They can review and approve code like committers. The key of code review is the code quality and correctness, while the approvals focus on overall acceptance of contributions. **Maintainer has all the responsibility and privilege of Committer** . In addition, Maintainer is also need to work out technical roadmap and undertake coordination within and outside the team. -+ 作为审核者至少3个月 -+ 作为主要审阅者至少参与了12次PR的审阅 -+ 审阅或合并至少30个基本PR到代码库 -+ 熟悉代码库 -+ 可以自我提名，也可以由子项目Maintainer提名，并且没有其他子项目Maintainer的反对 +**Definition**：*developer* entry in the OWNERS file owned by openEuler SIG. -### 责任与权力 +### Requirement -- **确定SIG所负责项目的技术路线**：包括规划和决策SIG技术方向、路标规划、架构演进。 -- **制定SIG所负责项目的发布计划**：确定SIG的关键需求和发布计划；参与社区的PM活动，并协调SIG计划和社区版本的里程碑时间表匹配 -- **参与社区协调活动**：作为SIG的代表参与openEuler技术委员会或理事会组织的活动和特定会议等 -- **召集SIG组会议**：定期召集SIG会议，决策SIG内上升的争议 ++ At least 3 months as committer ++ Participated in at least 12 PR reviews as the main reviewer ++ Review or merge at least 30 basic PR into the code repo ++ Being familiar with code repo ++ Could be self-nominated or nominated by sub-project Maintainer, and there is no objection from other sub-project Maintainers. +### Responsibility and Power +- **Work out technical roadmap for SIG project**：Including planning the SIG technical direction, roadmap, solution of software architecture evolution +- **Prepare release plan for SIG project**: Make key requirements and release plans for project;Participate in community PM activities and coordinate SIG initiatives to match community release milestone schedules +- **Participate in community coordination activities**：As a representative of SIG, Maintainer should attend the meetings and activites organized by Technical committee or the Community Council +- **Organize SIG meetings**：Regularly organize SIG meetings and make decisions on contentious issues within SIG \ No newline at end of file diff --git a/community-membership_cn.md b/community-membership_cn.md new file mode 100644 index 000000000..d6f2130a6 --- /dev/null +++ b/community-membership_cn.md @@ -0,0 +1,120 @@ +# 社区成员 + + +本文简要描述了openEuler社区中贡献者角色的各种职责。大部分角色的职责限于这些SIG(Special Interest Group)内： + +|角色| 职责范围（简要描述）|要求|定义的文件| +|:-----------|:-------------------- |:----------------------------------------------------- |:----------------------------------------------------------- | +|Contributor|项目的贡献者|| Gitee注册成员| +|Committer| 审核其他成员的贡献| SIG的积极贡献者，经验丰富，愿意投入精力参与到审核工作 | openEuler SIG拥有的存储库中OWNERS文件中的*Maintainer*条目。 | +| Maintainer| 项目Owner| 经验丰富，富有责任心、出色的技术能力和管理能力| openEuler SIG拥有的存储库中OWNERS文件中的*Maintainer*条目。 | + +*说明*：Maintainer和Committer在Gitee的权限上不做区分，两者的区分主要是集中在SIG治理的管理范围上。详细可以见下面的描述。 + + + +## 新的贡献者 + +欢迎新成员加入社区。我们有关于如何开始贡献的指导文档请参考：[openEuler贡献者指南](/zh/contributors/README.md) + + + +## 既有社区成员 + + +既有的社区成员应证明能够遵守本文中的原则，熟悉SIG的组织、角色、政策、软件、约定等，以及相关的技术和/或写作能力。社区成员角色的期望、职责和要求，请参考下面的内容。 + + + +## 贡献者 Contributor +贡献者是社区中持续活跃的贡献者，他们可以认领问题和PR，可以参与SIG组活动，并且可以为PR提交前完成测试。 + + + +### 要求 + ++ Gitee上的注册会员 ++ 为SIG或社区做出多方面贡献，包括不限于： + + 在Gitee上提交或审核PR + + 在Gitee上对问题进行归档或评论 + + 参与SIG或社区讨论 ++ 已阅读[贡献者指南](/zh/contributors/README.md) ++ 积极参与1个或多个SIG + + + +### 责任与权利 + ++ 响应被分配的问题和PR ++ 贡献的代码应该 + + 经过良好的测试 + + 能够让测试用例始终通过 + + 解决后继发生的错误或问题 + ++ 可以通过 `/lgtm`打开PR ++ 可以分配问题或PR，可以通过 `/cc @username`要求成员进行评论 ++ 可以针对PR自动运行测试。`/ok-to-test`不是必要的 ++ 可以使用`/ok-to-test`为具有`needs-ok-to-test`标签的PR进行操作，并使用诸如`/close`对PR进行关闭。 + +**注意**：经常贡献代码的成员应积极的参与代码审查，并努力成为SIG的*审核者Committer*。 + + + +## 审核者 Committer + +审核者能够在SIG或SIG的某些部分中审核代码的质量和正确性。审核者对代码库和软件工程原理非常了解。 + +定义者：openEuler SIG拥有的存储库中OWNERS文件中的*developer*条目。 + +### 要求 + ++ 作为贡献者至少3个月 ++ 作为主要审阅者至少参与了6次PR的审阅 ++ 审阅或合并至少20个基本PR到代码库 ++ 熟悉代码库 ++ 可以自我提名，或由该SIG的审核者或维护者提名 + +### 责任与权力 + ++ **评审PR**：对Contributor提交的PR完成评审，评审可以参考社区的[编程建议]()和[安全编程规范]()。 ++ **分发处理问题**:请参考“[问题处理流程]()“。 ++ **跟踪依赖性问题**：在开发分支中，其他SIG组的软件包的更新可能会到导致破坏本SIG内软件包的依赖关系。此时Committer会收到告警提示，Committer应尽力重建软件包。依赖关系出错可能会使最终用户无法更新系统，打包团队也会介入并重建存在依赖性问题的软件包，但Maintainer不应依赖这些重建。 ++ **如有接口变更，通知可能会影响到的SIG**：其他SIG或项目会依赖本SIG的软件包，对软件包接口的变更可能会对他们造成影响。Maintainer应了解并评审&决策变更造成的依赖影响，并公告和发送API或ABI变更的告警邮件。这类公告应在变更发生至少一周前完成，并应通知到所有可能受影响的SIG。具体请参考[接口变更通知流程]()。 ++ **更新和维护软件包版本**：遵守社区的[软件包更新质量控制策略]()完成软件包的更新。 ++ **和上游社区合作**，包括： + + 将所有变更推送到上游社区 + + 参与上游社区邮件列表 + + 获取上游社区的bug跟踪器的账户，并跟踪上游社区的重要bug + + 将严重的错误转发给上游社区以寻求帮助 + 更多信息，请参考“[上游社区软件包管理建议]()” ++ **和测试团队合作**，包括： + + 在提交软件包时，向质量检查人员提供如何调试/分类软件包的信息，以供问题的分类 + + 提供基本功能的测试用例，用于测试回归 + + 提交软件包更新时，提供有关更新中已经修复问题的测试用例，以供质量检查人员使用。 + + + +## 维护者 Maintainer + +维护者是SIG组的组长或者管理委员会成员，也是软件包的维护者，能够像Committer一样审查和批准代码贡献。代码审查的重点是代码质量和正确性，而批准的重点是对贡献的整体接受度。**所有Committer的责任与权力，Maintainer均具有**。除此之外，Maintainer还承担了团队的技术路线、内外协调等工作。 + +**定义**：openEuler SIG拥有的存储库中OWNERS文件中的*developer*条目 + + + +### 要求 + ++ 作为审核者至少3个月 ++ 作为主要审阅者至少参与了12次PR的审阅 ++ 审阅或合并至少30个基本PR到代码库 ++ 熟悉代码库 ++ 可以自我提名，也可以由子项目Maintainer提名，并且没有其他子项目Maintainer的反对 + +### 责任与权力 + +- **确定SIG所负责项目的技术路线**：包括规划和决策SIG技术方向、路标规划、架构演进。 +- **制定SIG所负责项目的发布计划**：确定SIG的关键需求和发布计划；参与社区的PM活动，并协调SIG计划和社区版本的里程碑时间表匹配 +- **参与社区协调活动**：作为SIG的代表参与openEuler技术委员会或理事会组织的活动和特定会议等 +- **召集SIG组会议**：定期召集SIG会议，决策SIG内上升的争议 + + diff --git a/zh/contributors/README.md b/zh/contributors/README.md index 2af3668ba..54b25c3bc 100644 --- a/zh/contributors/README.md +++ b/zh/contributors/README.md @@ -55,7 +55,7 @@

社区期望

-openEuler是一个开源社区。因此它完全依赖于社区提供开发，以及友好和协作的环境，请查看[社区成员角色](./../../community-membership.md)。社区鼓励您在积累经验的同时提高你的贡献级别。 +openEuler是一个开源社区。因此它完全依赖于社区提供开发，以及友好和协作的环境，请查看[社区成员角色](./../../community-membership_cn.md)。社区鼓励您在积累经验的同时提高你的贡献级别。 -- Gitee