Skip to content

chore: minor improve for committer guidelines #410

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
imbajin merged 4 commits into from
Jul 17, 2025
Merged

chore: minor improve for committer guidelines #410

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
c8d8c31
setup
VGalaxies Jul 2, 2025
865c944
new committers need to be promptly updated on the page incubator.apac…
VGalaxies Jul 16, 2025
46fbf3d
Apply suggestion from @Copilot
VGalaxies Jul 16, 2025
5326fe6
Apply suggestion from @Copilot
VGalaxies Jul 16, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
30 changes: 27 additions & 3 deletions content/cn/docs/contribution-guidelines/committer-guidelines.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -22,7 +22,7 @@ weight: 5

**讨论 (DISCUSS) → 投票 (VOTE) → 邀请 (INVITE) → 公告 (ANNOUNCE)**

## 1. 发起社区邮件讨论 (DISCUSS)
## 发起社区邮件讨论 (DISCUSS)

任何 HugeGraph 的 (P)PMC 成员都可以发起投票讨论，在发现社区贡献者任何有价值的贡献并取得候选人本人同意后，可以在 private@hugegraph.apache.org 发起讨论。
讨论邮件里提议者要把候选人的贡献说清楚，并最好给出确认贡献的 URL 等信息，便于大家讨论分析。
Expand Down Expand Up @@ -103,7 +103,7 @@ Thanks!

Mailing Lists 的参与则可使用 https://lists.apache.org/list?dev@hugegraph.apache.org:lte=10M:xxx 查询。

## 2. 发起社区邮件投票 (VOTE)
## 发起社区邮件投票 (VOTE)

如果讨论邮件在规定时间内没有收到分歧信息，投票发起者需要在 private@hugegraph.apache.org 发起对 Committer 的选举投票。

Expand Down Expand Up @@ -143,7 +143,7 @@ Thanks!
To: private@hugegraph.apache.org
Subject: [RESULTS][VOTE] xxx as a HugeGraph Committer

Hi all: The vote for "xxx" as an HugeGraph Committer has PASSED and closed now.
Hi all: The vote for "xxx" as a HugeGraph Committer has PASSED and closed now.

The result is as follows: X PMC +1 Votes:
- A (PMC ID)
Expand Down Expand Up @@ -330,6 +330,30 @@ Thanks!
The Apache HugeGraph PPMC
```

## 更新 clutch status 信息

负责提名的 PMC 成员需下载 clutch status 信息, 并进行更新, 生效后可在 [clutch](https://incubator.apache.org/clutch/hugegraph.html) 和 [projects](https://incubator.apache.org/projects/hugegraph.html) 页面查询。流程参考如下：

```text
# 1. 下载 clutch status 信息
svn co https://svn.apache.org/repos/asf/incubator/public/trunk/content/projects/

# 2. 修改编辑 (注意下面内容仅供参考)
cd projects
vim hugegraph.xml

<section id="News">
<title>News</title>
<ul>
<li>YYYY-MM-DD New Committer: xxx</li>
<li>...</li>
</ul>
</section>

# 3. 提交
svn commit -m "update news for hugegraph"
```

# 参考

1. https://community.apache.org/newcommitter.html (ASF 官方文档)
Expand Down
30 changes: 27 additions & 3 deletions content/en/docs/contribution-guidelines/committer-guidelines.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -21,7 +21,7 @@ weight: 5

**Discussion → Vote → Invitation → Announcement**

## 1. Initiate Community Discussion (DISCUSS)
## Initiate Community Discussion (DISCUSS)

Any (P)PMC member of HugeGraph can initiate a voting discussion. After identifying valuable contributions from a community contributor and obtaining the candidate's consent, a discussion can be initiated via private@hugegraph.apache.org.
The initiator of the discussion should clearly state the candidate's contributions in the discussion email and provide URLs or other information for confirming the contributions, facilitating discussion and analysis.
Expand Down Expand Up @@ -101,7 +101,7 @@ For contribution links in discussion emails, you can use the statistical feature

For participation in mailing lists, you can use https://lists.apache.org/list?dev@hugegraph.apache.org:lte=10M:xxx.

## 2. Initiate Community Voting Email (VOTE)
## Initiate Community Voting Email (VOTE)

If there are no dissenting opinions within the specified time frame of the discussion email, the initiator of the discussion needs to initiate a voting email for the committer election at private@hugegraph.apache.org.

Expand Down Expand Up @@ -141,7 +141,7 @@ After the voting email concludes, the initiator of the vote needs to remind the
To: private@hugegraph.apache.org
Subject: [RESULTS][VOTE] xxx as a HugeGraph Committer

Hi all: The vote for "xxx" as an HugeGraph Committer has PASSED and closed now.
Hi all: The vote for "xxx" as a HugeGraph Committer has PASSED and closed now.

The result is as follows: X PMC +1 Votes:
- A (PMC ID)
Expand Down Expand Up @@ -328,6 +328,30 @@ Thanks!
The Apache HugeGraph PPMC
```

## Update clutch status information

PMC members responsible for nominations need to download clutch status information and update it. Once effective, it can be viewed on the [clutch](https://incubator.apache.org/clutch/hugegraph.html) and [projects](https://incubator.apache.org/projects/hugegraph.html) pages. The process is as follows:

```text
# 1. Download clutch status information
svn co https://svn.apache.org/repos/asf/incubator/public/trunk/content/projects/

# 2. Modify and edit (note the following is for reference only)
cd projects
vim hugegraph.xml

<section id="News">
<title>News</title>
<ul>
<li>YYYY-MM-DD New Committer: xxx</li>
<li>...</li>
</ul>
</section>

# 3. Commit
svn commit -m "update news for hugegraph"
```

# References

1. https://community.apache.org/newcommitter.html (ASF official documentation)
Expand Down