Committer指南

如何成为bRPC Committer

简介

Apache社区的参与者具有以下角色:贡献者(Contributor)提交者(Committer)PMC(项目成员委员会)成员

当个人贡献被项目接受时,他/她将自动成为贡献者。 Committer 和 PMC 成员在共识投票后由 PMC 邀请。

在这里,我们将仅讨论 bRPC 社区邀请 Committer 和 PMC 成员的一些准则,以便能够有效地估计开发者在社区中的参与度。

The Apache Way:

在任何人成为 Apache 项目的 Committer 或 PMC 成员之前,他们应该首先了解“什么是TheApacheWay”。

提交者指南:

有重要的功能贡献(不限于代码),或长期参与社区建设(错误修复、代码审查、文档翻译和校对、社区外展等) 参与公共领域的社区讨论并产生积极影响。

PMC会员指南:

能够积极参与社区维护工作,如回复邮件、组织wiki、发布管理、代码审查等。 认同 Apache 社区理念,能够积极推动社区发展。

同行评审:

上述要求具有很强的主观性,无法量化。因此,PMC需要形成定期审核机制,对符合条件的人员进行讨论和邀请。

每 1-2 个月进行一次审查,以提名和讨论合适的候选人


具体流程

1. 如何发展committer

前置条件

  1. 贡献者commit数量达到10个以上
  2. 贡献者个人有意愿接受邀请成为committer
  3. 贡献者订阅dev@brpc.apache.org,并发邮件介绍自己

成为committer的路程

  1. 提名者在private@brpc中发起讨论和投票,投票通过即OK (最少3+1, +1 > -1),投票邮件模版https://community.apache.org/newcommitter.html#committer-vote-template

  2. 提名者发送close vote邮件给private@brpc和private@incubator ,标题可以为subject [RESULT][VOTE],close邮件模版https://community.apache.org/newcommitter.html#close-vote

  3. 提名者给被提名者发invite letter,并得到回复后再提示他提交ICLA,模版见https://community.apache.org/newcommitter.html#Committer%20Invite%20Template

  4. 被提名者填写CLA, 个人贡献者需要下载ICLA填写个人信息并签名,发送电子版给 secretary@apache.org。(注意:ICLA需要填写信息完全,包括邮寄地址和签名,否则会被ASF的秘书打回)个人信息填写项(除签名外)可以使用 PDF 阅读器或浏览器填写,填写后保存进行签名。签名方式支持:

    • 打印 pdf 文件,手写签名后扫描为电子版;
    • 使用支持手写的设备进行电子签名;
    • 使用 gpg 进行电子签名,即对填写好个人基本信息的 pdf 文件进行操作(需要提前生成与登记邮箱匹配的公钥/密钥对):gpg --armor --detach-sign icla.pdf
    • 使用 DocuSign 进行签名;
  5. 提名者发送announce邮件到dev@brpc.apache.org

如何赋予committer在github上的权限

  1. 加为committer https://whimsy.apache.org/roster/ppmc/brpc

  2. 让他设置github id https://id.apache.org/

  3. 让他访问该网址,获得github的权限 https://gitbox.apache.org/setup/

Apache 官网new committer相关的文档

Suggested steps from secretary@apache.org

Please do these things:

  1. Hold the discussion and vote on your private@ list. This avoids any issues related to personnel, which should remain private.
  2. If the vote is successful, announce the result to the private@ list with a new email thread with subject [RESULT][VOTE]. This makes it easier for secretary to find the result of the vote in order to request the account at the time of the filing of the ICLA.
  3. Only if the candidate accepts committership, announce the new committer on your dev@ list.

Doing these things will make everyone’s job easier.

2. 如何把committer变成为PPMC

流程参考:Apache官网文档

实际流程

  1. 在private@brpc中发起讨论,如果没有反对,则继续
  2. 在private@brpc中发起投票
  3. 在private@brpc中发邮件,结束投票,并通知private@incubator.apache.org
  4. 在private@brpc中和dev中announce new PPMC
  5. 设定他的权限,通过访问https://whimsy.apache.org/roster/ppmc/brpc
  6. 帮他订阅private邮件组,参见https://whimsy.apache.org/committers/moderationhelper.cgi

修改于 2023年5月16日: add security bug fix pages (#148) (a29da9f)