This is an automated email from the ASF dual-hosted git repository.
lahmxu pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/shenyu-website.git
The following commit(s) were added to refs/heads/main by this push:
new 1b4ae73b0 refactor committer and pmc guide (#873)
1b4ae73b0 is described below
commit 1b4ae73b097354166f6ca8517ef2ae14c2b3c560
Author: xiaoyu <[email protected]>
AuthorDate: Mon Mar 20 15:30:41 2023 +0800
refactor committer and pmc guide (#873)
* refactor committer and pmc guide
* refactor committer and pmc guide
---------
Co-authored-by: xiaoyu137 <[email protected]>
---
community/5-committer.md | 178 ++++++++++++++++++++-
community/7-pmc.md | 112 +++++++++++++
community/7-vote-pmc.md | 33 ----
.../current/5-committer.md | 171 ++++++++++++++++++++
.../current/7-pmc.md | 113 +++++++++++++
.../current/7-vote-pmc.md | 33 ----
6 files changed, 571 insertions(+), 69 deletions(-)
diff --git a/community/5-committer.md b/community/5-committer.md
index 27fa2f9e1..92abffdc0 100644
--- a/community/5-committer.md
+++ b/community/5-committer.md
@@ -1,5 +1,5 @@
---
-title: Committer
+title: Committer Guide
sidebar_position: 5
description: Apache ShenYu Committer's Guide
author: "xiaoyu"
@@ -20,9 +20,164 @@ After you have made a lot of contributions, the community
will nominate. Become
**1. Follow this [Committer
Guide](https://community.apache.org/newcommitter.html) to complete the vote**
-* If you have not signed the ICLA, Please follow the [ICLA
Guide](https://shenyu.apache.org/community/icla/) to complete the signing
+* Promotion Prepare. New Committer list all contributions to PMC member:
-* If you have ever signed an ICLA, please provide request account like this:
+```
+### shenyu （project name）
+[total commits](https://github.com/apache/shenyu/commits?author=Nominee)
+> code++, code--
+
+- [ISSUE #xx] do something #pr
+
+### shenyu-website
+
+[total
commits](https://github.com/apache/shenyu-website/commits?author=Nominee)
+> code++, code--
+
+- [ISSUE #xx] do something #pr
+
+```
+
+* Vote new Committer list to <[email protected]> :
+
+```
+Title : [VOTE] New committer: （Nominee）
+Main Text：
+
+Hi, PMCs
+
+This is a formal vote about inviting (Nominee) as our new committer.
+
+(Reason for nomination)
+
+The vote will be open for at least 72 hours or until the necessary number of
votes are reached.
+
+Please vote accordingly:
+
+[ ] +1 approve
+
+[ ] +0 no opinion
+
+[ ] -1 disapprove with the reason
+
+The following links will direct you to Nominee work.
+
+list Nominee all contributions：
+
+(Nominee Prepare)
+
+```
+
+* Vote result list to <[email protected]>
+
+```
+Title [RESULT] [VOTE] New committer:(Nominee)
+Main Text：
+I am glad to receive your votes, and the voting result is[1],
+（total number） +1 votes, (total number) +0 votes, （total number）-1 votes
+
++1 PMC members name (PMC)
+
+[1]: vote thread refer to
https://lists.apache.org/[email protected]
+Therefore, I will send the invitation to (Nominee).
+
+```
+
+* Invitation new Committer to Nominee email and copied to
<[email protected]>:
+> new committer need prepare an available email.
+
+```
+Title:Invitation to become apache shenyu committer (Nominee)
+Main Text：
+
+Hello (Nominee),
+
+The Apache ShenYu Project Management Committee (PMC) hereby
+offers you committer privileges to the project. These privileges are
+offered on the understanding that you'll use them reasonably and with
+common sense. We like to work on trust
+rather than unnecessary constraints.
+Being a committer enables you to more easily make changes without
+needing to go through the patch submission process.
+Being a committer does not require you to participate any more than
+you already do. It does tend to make one even more committed. You
+will probably find that you spend more time here.
+Of course, you can decline and instead remain as a contributor,
+participating as you do now.
+A. This personal invitation is a chance for you to accept or decline
+in private. Either way, please let us know in reply to the
[email protected]
+address only.
+B. If you accept, the next step is to register an iCLA:
+1. Details of the iCLA and the forms are found through this link:
+http://www.apache.org/licenses/#clas
+
+2. Instructions for its completion and return to the Secretary of
+the ASF are found at http://www.apache.org/licenses/#submitting
+
+3. When you transmit the completed iCLA, request to notify the
+Apache shenyu and choose a unique Apache id. Look to see if your
+preferred id is already taken at
+http://people.apache.org/committer-index.html
+This will allow the Secretary to notify the PMC when your iCLA has
+been recorded.
+When recording of your iCLA is noticed, you will receive a follow-up
+message with the next steps for establishing you as a committer.
+
+Best wishes,
+Apache ShenYu PMC
+```
+
+* if new Committer accepted invitation, reply mail:
+
+> New committer accepted invitation need copied to <[email protected]>
+
+```
+Hi (Nominee),
+
+Welcome! Here are the next steps. After that we will make an
+announcement to the shenyu-dev list.
+
+you not need to submit iCLA again.
+
+You need to send a Contributor License Agreement to the ASF. Normally
+you would send an Individual CLA. If you also make contributions done
+in work time or using work resources then see the Corporate CLA. Ask
+us if you have any issues.
+http://www.apache.org/licenses/#clas
+
+You need to choose a preferred ASF user name and alternatives. In
+order to ensure it is available you can view a list of taken ids at
+http://people.apache.org/committer-index.html
+Please notify us when you have submitted the CLA and by what means you
+did so. This will enable us to monitor its progress.
+
+We will arrange for your Apache user account when the CLA has been recorded.
+
+After that is done, please make follow-up replies to the shenyu-dev
+list. We generally discuss everything there and keep the
[email protected] list for occasional matters which must be
+private.
+
+The developer section of the website describes the roles and provides
+other resources:
+http://www.apache.org/foundation/how-it-works.html
+http://www.apache.org/dev/
+
+Just as before you became a committer, participation in any ASF
+community requires adherence to the ASF Code of Conduct:
+https://www.apache.org/foundation/policies/conduct.html
+
+Here is the guideline for sign icla:
+https://shenyu.apache.org/community/icla
+
+Here is the guideline for all of the Apache ShenYu committers:
+https://shenyu.apache.org/community/committer
+```
+
+* If nominee have not signed the ICLA, Please follow the [ICLA
Guide](https://shenyu.apache.org/community/icla/) to complete the signing
+
+* If nominee have ever signed an ICLA, please provide request account like
this:
```
Prospective userid:
@@ -39,6 +194,23 @@ What time to receive the reply signed by icla:
[two-factor
authentication](https://docs.github.com/cn/organizations/keeping-your-organization-secure/managing-two-factor-authentication-for-your-organization/requiring-two-factor-authentication-in-your-organization)
+**5. ANNOUNCE to <[email protected]>**
+
+```
+Title: [ANNOUNCE] New committer: (Nominee)
+Main Text：
+
+The Project Management Committee (PMC) for Apache ShenYu
+has invited (Nominee) to become a committer and we are pleased to
+announce that he has accepted.
+
+(Nominee) is active in the Apache ShenYu community, hope to see your
+further interactions with the community!
+Thanks for your contributions.
+Best wishes!
+```
+
+
## Committer Responsibilities {#committer-responsibilities}
* Solving issue problems.
diff --git a/community/7-pmc.md b/community/7-pmc.md
new file mode 100644
index 000000000..6a146981a
--- /dev/null
+++ b/community/7-pmc.md
@@ -0,0 +1,112 @@
+---
+title: PMC Guide
+sidebar_position: 7
+description: Voting in a new PMC member
+categories: "Apache ShenYu"
+tags: ["PMC-Member Guide"]
+---
+
+# Vote new PMC member
+
+**1. Follow this [PMC MEMBERSHIP
MANAGEMENT](https://www.apache.org/dev/pmc.html#pmcmembers) to complete the
vote**
+
+* Vote new PMC member thread to <[email protected]>
+
+```
+Tilte: [VOTE] New PMC member (Nominee)
+
+Main Text :
+
+I would like to nominate (Nominee) to join PMC member.
+
+(Reason for nomination)
+
+The vote will be open for at least 72 hours or until the necessary
+number of votes are reached.
+
+Please vote accordingly:
+
+[ ] +1 approve
+
+[ ] +0 no opinion
+
+[ ] -1 disapprove with the reason
+
+The following links will direct you to (Nominee) work.
+
+list Nominee all contributions：
+
+```
+
+* Vote result list to <[email protected]>
+
+```
+Title [RESULT] [VOTE] New PMC member :(Nominee)
+Main Text：
+I am glad to receive your votes, and the voting result is[1],
+（total number） +1 votes, (total number) +0 votes, （total number）-1 votes
+
++1 PMC members name (PMC)
+
+[1]: vote thread refer to
https://lists.apache.org/[email protected]
+
+The vote is successful,
+
+I will proceed with the invitation. Note that according to new rules,
+we can invite the candidate immediately, we do not need to wait 72
+hours after board notification.
+
+```
+
+* Notice Apache Board <[email protected]> and copied to
<[email protected]>
+
+```
+Tilte [NOTICE] （Nominee） for Apache ShenYu PMC
+
+Main Text:
+
+Apache ShenYu proposes to invite Nominee (apache id) to join the PMC.
+
+The vote result is available here:
+
+(vote result thread refer to
https://lists.apache.org/[email protected])
+
+```
+
+**2. Add the new PMC to
[roster](https://whimsy.apache.org/roster/committee/shenyu)**
+
+**3. Notify the new PMC members to subscribe to the private mailing
list：[[email protected]](mailto:[email protected])**
+
+**4. ANNOUNCE to <[email protected]>**
+
+```
+Title: [ANNOUNCE] New PMC member: (Nominee)
+Main Text：
+
+The Project Management Committee (PMC) for Apache ShenYu
+has invited (Nominee) to become a member and we are pleased to
+announce that he has accepted.
+
+(Nominee) is active in the Apache ShenYu community, hope to see your
+further interactions with the community!
+Thanks for your contributions.
+Best wishes!
+```
+
+# PMC Member Responsibilities
+
+## Developing New Submitters
+
+Developing committers is one of the most important functions of any PMC, and
PMC members need to guide contributors to contribute smoothly, monitor their
contribution volume, and nominate contributors as committers when appropriate.
+
+## Participate in community activities
+
+This includes but is not limited to answering questions, giving talks,
promoting projects, maintaining the brand, etc.
+
+## Release and version checking
+
+PMC members should actively become release managers to release new releases.
If you are not a release manager, you should do release checking when a new
release is under publishing.
+
+**The content refers to**
+
+https://www.apache.org/dev/pmc.html
diff --git a/community/7-vote-pmc.md b/community/7-vote-pmc.md
deleted file mode 100644
index b70616fa6..000000000
--- a/community/7-vote-pmc.md
+++ /dev/null
@@ -1,33 +0,0 @@
----
-title: Voting in a new PMC member
-sidebar_position: 7
-description: Voting in a new PMC member
-categories: "Apache ShenYu"
-tags: ["Vote-PMC-Member"]
----
-
-**1. Follow this [PMC MEMBERSHIP
MANAGEMENT](https://www.apache.org/dev/pmc.html#pmcmembers) to complete the
vote**
-
-Note that the notification email after the vote is approved should be sent to
[email protected] in the main and copied to [email protected].
-
-**2. Add the new PMC to
[roster](https://whimsy.apache.org/roster/committee/shenyu)**
-
-**3. Notify the new PMC members to subscribe to the private mailing
list：[[email protected]](mailto:[email protected])**
-
-**4. PMC Member Responsibilities**
-
-## Developing New Submitters
-
-Developing committers is one of the most important functions of any PMC, and
PMC members need to guide contributors to contribute smoothly, monitor their
contribution volume, and nominate contributors as committers when appropriate.
-
-## Participate in community activities
-
-This includes but is not limited to answering questions, giving talks,
promoting projects, maintaining the brand, etc.
-
-## Release and version checking
-
-PMC members should actively become release managers to release new releases.
If you are not a release manager, you should do release checking when a new
release is under publishing.
-
-**The content refers to**
-
-https://www.apache.org/dev/pmc.html
diff --git
a/i18n/zh/docusaurus-plugin-content-docs-community/current/5-committer.md
b/i18n/zh/docusaurus-plugin-content-docs-community/current/5-committer.md
index e7717a39e..d51414dd2 100755
--- a/i18n/zh/docusaurus-plugin-content-docs-community/current/5-committer.md
+++ b/i18n/zh/docusaurus-plugin-content-docs-community/current/5-committer.md
@@ -21,6 +21,161 @@ cover: "/img/architecture/shenyu-framework.png"
**1、按照这个 [Committer 指南](https://community.apache.org/newcommitter.html) 完成投票**
+* 提名前准备. 新的committer列出自己的所有的申请贡献给PMC成员:
+
+```
+### shenyu （project name）
+[total commits](https://github.com/apache/shenyu/commits?author=Nominee)
+> code++, code--
+
+- [ISSUE #xx] do something #pr
+
+### shenyu-website
+
+[total
commits](https://github.com/apache/shenyu-website/commits?author=Nominee)
+> code++, code--
+
+- [ISSUE #xx] do something #pr
+
+```
+
+* 在<[email protected]>邮件列表提名committer :
+
+```
+标题 : [VOTE] New committer: （Nominee）
+正文：
+
+Hi, PMCs
+
+This is a formal vote about inviting (Nominee) as our new committer.
+
+(Reason for nomination)
+
+The vote will be open for at least 72 hours or until the necessary number of
votes are reached.
+
+Please vote accordingly:
+
+[ ] +1 approve
+
+[ ] +0 no opinion
+
+[ ] -1 disapprove with the reason
+
+The following links will direct you to Nominee work.
+
+list Nominee all contributions：
+
+(Nominee Prepare)
+
+```
+
+* 在<[email protected]>邮件列表宣布结果:
+
+```
+标题 [RESULT] [VOTE] New committer:(Nominee)
+正文：
+I am glad to receive your votes, and the voting result is[1],
+（total number） +1 votes, (total number) +0 votes, （total number）-1 votes
+
++1 PMC members name (PMC)
+
+[1]: vote thread refer to
https://lists.apache.org/[email protected]
+Therefore, I will send the invitation to (Nominee).
+
+```
+
+* 给新的committer发送邮件，并且抄送给 <[email protected]>:
+> 新的committer提供可用的邮箱地址，如果签署过icla，最好提供一样的邮箱地址.
+
+```
+标题:Invitation to become apache shenyu committer (Nominee)
+正文：
+
+Hello (Nominee),
+
+The Apache ShenYu Project Management Committee (PMC) hereby
+offers you committer privileges to the project. These privileges are
+offered on the understanding that you'll use them reasonably and with
+common sense. We like to work on trust
+rather than unnecessary constraints.
+Being a committer enables you to more easily make changes without
+needing to go through the patch submission process.
+Being a committer does not require you to participate any more than
+you already do. It does tend to make one even more committed. You
+will probably find that you spend more time here.
+Of course, you can decline and instead remain as a contributor,
+participating as you do now.
+A. This personal invitation is a chance for you to accept or decline
+in private. Either way, please let us know in reply to the
[email protected]
+address only.
+B. If you accept, the next step is to register an iCLA:
+1. Details of the iCLA and the forms are found through this link:
+http://www.apache.org/licenses/#clas
+
+2. Instructions for its completion and return to the Secretary of
+the ASF are found at http://www.apache.org/licenses/#submitting
+
+3. When you transmit the completed iCLA, request to notify the
+Apache shenyu and choose a unique Apache id. Look to see if your
+preferred id is already taken at
+http://people.apache.org/committer-index.html
+This will allow the Secretary to notify the PMC when your iCLA has
+been recorded.
+When recording of your iCLA is noticed, you will receive a follow-up
+message with the next steps for establishing you as a committer.
+
+Best wishes,
+Apache ShenYu PMC
+```
+
+* 新的committer接受邀请, 回复如下邮件:
+
+> 新的提交者接受邀请的回复需要抄送给 <[email protected]>
+
+```
+Hi (Nominee),
+
+Welcome! Here are the next steps. After that we will make an
+announcement to the shenyu-dev list.
+
+you not need to submit iCLA again.
+
+You need to send a Contributor License Agreement to the ASF. Normally
+you would send an Individual CLA. If you also make contributions done
+in work time or using work resources then see the Corporate CLA. Ask
+us if you have any issues.
+http://www.apache.org/licenses/#clas
+
+You need to choose a preferred ASF user name and alternatives. In
+order to ensure it is available you can view a list of taken ids at
+http://people.apache.org/committer-index.html
+Please notify us when you have submitted the CLA and by what means you
+did so. This will enable us to monitor its progress.
+
+We will arrange for your Apache user account when the CLA has been recorded.
+
+After that is done, please make follow-up replies to the shenyu-dev
+list. We generally discuss everything there and keep the
[email protected] list for occasional matters which must be
+private.
+
+The developer section of the website describes the roles and provides
+other resources:
+http://www.apache.org/foundation/how-it-works.html
+http://www.apache.org/dev/
+
+Just as before you became a committer, participation in any ASF
+community requires adherence to the ASF Code of Conduct:
+https://www.apache.org/foundation/policies/conduct.html
+
+Here is the guideline for sign icla:
+https://shenyu.apache.org/community/icla
+
+Here is the guideline for all of the Apache ShenYu committers:
+https://shenyu.apache.org/community/committer
+```
+
* 如果没有签署过 ICLA，请按照 [ICLA 签署指南](https://shenyu.apache.org/zh/community/icla/)
完成签署
* 如果曾经签署过 ICLA，请提供如下信息：
@@ -40,6 +195,22 @@ What time to receive the reply signed by icla:
[双重身份验证](https://docs.github.com/cn/organizations/keeping-your-organization-secure/managing-two-factor-authentication-for-your-organization/requiring-two-factor-authentication-in-your-organization)
+**5. 在<[email protected]>邮件列表发布新闻公告**
+
+```
+标题: [ANNOUNCE] New committer: (Nominee)
+正文：
+
+The Project Management Committee (PMC) for Apache ShenYu
+has invited (Nominee) to become a committer and we are pleased to
+announce that he has accepted.
+
+(Nominee) is active in the Apache ShenYu community, hope to see your
+further interactions with the community!
+Thanks for your contributions.
+Best wishes!
+```
+
## 提交者责任
- 解答issue问题。
diff --git a/i18n/zh/docusaurus-plugin-content-docs-community/current/7-pmc.md
b/i18n/zh/docusaurus-plugin-content-docs-community/current/7-pmc.md
new file mode 100644
index 000000000..09095490b
--- /dev/null
+++ b/i18n/zh/docusaurus-plugin-content-docs-community/current/7-pmc.md
@@ -0,0 +1,113 @@
+---
+title: PMC指南
+sidebar_position: 7
+description: PMC指南
+categories: "Apache ShenYu"
+tags: ["PMC-Member"]
+---
+
+# 提名新的PMC成员
+
+**1、参考 [PMC MEMBERSHIP
MANAGEMENT](https://www.apache.org/dev/pmc.html#pmcmembers) 完成投票**
+
+* 在<[email protected]>邮件列表发起Vote流程
+
+```
+Tilte: [VOTE] New PMC member (Nominee)
+
+Main Text :
+
+I would like to nominate (Nominee) to join PMC member.
+
+(Reason for nomination)
+
+The vote will be open for at least 72 hours or until the necessary
+number of votes are reached.
+
+Please vote accordingly:
+
+[ ] +1 approve
+
+[ ] +0 no opinion
+
+[ ] -1 disapprove with the reason
+
+The following links will direct you to (Nominee) work.
+
+（list Nominee all contributions）
+
+```
+
+* 在<[email protected]>宣布投票结果：
+> 根据新的规则,可以立即邀请候选人，我们不需要等待通知Board后的72小时
+
+```
+Title [RESULT] [VOTE] New PMC member :(Nominee)
+Main Text：
+I am glad to receive your votes, and the voting result is[1],
+（total number） +1 votes, (total number) +0 votes, （total number）-1 votes
+
++1 PMC members name (PMC)
+
+[1]: vote thread refer to
https://lists.apache.org/[email protected]
+
+The vote is successful,
+
+I will proceed with the invitation. Note that according to new rules,
+we can invite the candidate immediately, we do not need to wait 72
+hours after board notification.
+
+```
+
+* 通知Apache Board<[email protected]> 并且抄送给 <[email protected]>
+
+```
+Tilte [NOTICE] （Nominee） for Apache ShenYu PMC
+
+Main Text:
+
+Apache ShenYu proposes to invite Nominee (apache id) to join the PMC.
+
+The vote result is available here:
+
+(vote result thread refer to
https://lists.apache.org/[email protected])
+
+```
+
+**2、在 [roster](https://whimsy.apache.org/roster/committee/shenyu) 中添加新的 PMC**
+
+**3、通知新 PMC 成员订阅 private
邮件列表：[[email protected]](mailto:[email protected])**
+
+**4. 在<[email protected]>发布新闻**
+
+```
+Title: [ANNOUNCE] New PMC member: (Nominee)
+Main Text：
+
+The Project Management Committee (PMC) for Apache ShenYu
+has invited (Nominee) to become a member and we are pleased to
+announce that he has accepted.
+
+(Nominee) is active in the Apache ShenYu community, hope to see your
+further interactions with the community!
+Thanks for your contributions.
+Best wishes!
+```
+
+# PMC成员职责
+
+## 发展新的提交者
+
+发展提交者是任何 PMC 最重要的功能之一。PMC 成员需要指导贡献者平滑的做出贡献，关注其贡献量，并在合适的时候提名贡献者成为提交者。
+
+## 参与社区活动
+
+包括但不限于回答问题、发表演讲、推广项目、维护品牌等。
+
+## 版本发布和版本检查
+
+PMC 成员应积极成为发布经理发布新版本。如果不是发布经理，应在新版本发布时做好发版检查。
+
+**以上内容参考**
+
+https://www.apache.org/dev/pmc.html
diff --git
a/i18n/zh/docusaurus-plugin-content-docs-community/current/7-vote-pmc.md
b/i18n/zh/docusaurus-plugin-content-docs-community/current/7-vote-pmc.md
deleted file mode 100644
index 21856857b..000000000
--- a/i18n/zh/docusaurus-plugin-content-docs-community/current/7-vote-pmc.md
+++ /dev/null
@@ -1,33 +0,0 @@
----
-title: 提名新的 PMC 成员
-sidebar_position: 7
-description: 提名新的 PMC 成员
-categories: "Apache ShenYu"
-tags: ["Vote-PMC-Member"]
----
-
-**1、参考 [PMC MEMBERSHIP
MANAGEMENT](https://www.apache.org/dev/pmc.html#pmcmembers) 完成投票**
-
-注意，投票通过后的通知邮件要主送 [email protected]，抄送 [email protected]。
-
-**2、在 [roster](https://whimsy.apache.org/roster/committee/shenyu) 中添加新的 PMC**
-
-**3、通知新 PMC 成员订阅 private
邮件列表：[[email protected]](mailto:[email protected])**
-
-**4、PMC 成员职责**
-
-## 发展新的提交者
-
-发展提交者是任何 PMC 最重要的功能之一。PMC 成员需要指导贡献者平滑的做出贡献，关注其贡献量，并在合适的时候提名贡献者成为提交者。
-
-## 参与社区活动
-
-包括但不限于回答问题、发表演讲、推广项目、维护品牌等。
-
-## 版本发布和版本检查
-
-PMC 成员应积极成为发布经理发布新版本。如果不是发布经理，应在新版本发布时做好发版检查。
-
-**以上内容参考**
-
-https://www.apache.org/dev/pmc.html
