维护者的职责

维护者是贡献者生态的关键成员,背景多样: 既有利用业余时间工作的无偿爱好者,也有以参与项目为本职工作的雇员。 维护工作包括:

  • 审查补丁并提出修改建议;

  • 收集补丁、准备拉取请求;

  • 关注所负责领域的长期健康;

  • 参与其他项目活动。

维护者也是普通人,同样面临工作过载和倦怠。 与其他人一样,他们应遵守 行为准则, 并成为优秀社区协作者的榜样。

MAINTAINERS 文件

MAINTAINERS 保存正式维护者名单。文件可由机器读取,配置正确的 Git (见 抄送相关维护者)可在补丁修改对应领域时自动抄送他们。

文件还描述代码领域的维护状态,体现维护活跃程度。

MAINTAINERS 中的支持状态含义

状态

含义

Supported

有人受雇负责此部分。

Maintained

确实有人维护。

Odd Fixes

有维护者,但时间有限,通常只能偶尔提交补丁。

Orphan

当前没有维护者。

Obsolete

已过时,应使用其他实现。

有人受雇支持某个组件,不表示其工作就是为你提供支持。 这是开源项目,代码没有保证,项目也不保证处理缺陷或功能请求。

成为审查者

多数维护者先从子系统审查者做起。欢迎任何人在邮件列表审查代码, 但在 MAINTAINERS 中加入类似以下内容后:

R: Random Hacker <rhacker@example.com>

你就成为“指定审查者”,预期主动、定期提供反馈。 相关子系统的补丁也会自动抄送给你。

成为维护者

维护者是主动承担,或受邀照看某个代码领域的志愿者。 通常他们已通过贡献和代码审查向社区证明,自己充分理解该子系统, 也值得信任,能够积极贡献并与其他人良好合作。

流程很简单:向邮件列表发送更新 MAINTAINERS 的补丁。 添加新子系统时,它有时属于较大补丁序列的一部分。 也可以由准备退出的维护者与其他贡献者讨论后,提名接任者。

补丁经审查合并后,剩下的步骤是确保 GPG 密钥已获得签名。

维护者 GPG 密钥

GPG 用于签名拉取请求,证明它确实来自维护者。 如果密钥尚未获得 QEMU 社区成员签名,应安排参加 密钥签名聚会,例如 KVM Forum, 或另行安排请参会者为密钥签名。 密钥签名要求与另一位社区成员 当面见面 [1],请作好安排。