这是关于通过电子邮件进行代码审查的教程,主要内容如下:
- 引言:通过电子邮件进行代码审查简单高效且可扩展,但开始时可能令人望而生畏。基本工作流程是通过回复电子邮件来审查补丁,每个人的电子邮件工作流程略有不同,本教程将介绍一种简单的开始方式。
- 介绍 aerc:有效使用 git 电子邮件工作流程需要选择一个适合的电子邮件客户端,推荐使用 aerc,它是专门为在终端模拟器中进行代码审查而设计的,轻量级且可按需启动。aerc 可能通过系统包管理器安装,初始配置简单,有许多其他适合 git 的电子邮件客户端可供选择。
- 准备沙盒:为实验电子邮件工作流程准备了一个沙盒环境,基于 scdoc 项目,包含 git 仓库和示例补丁。克隆沙盒项目后,可通过 aerc 命令导入示例邮件,示例邮件已去除原始发送者地址。
- 审查补丁:可以浏览沙盒中的讨论和 aerc 界面,尝试代码审查,如对 Kirill Chibisov 的补丁提供反馈。
- 应用和测试补丁:使用 git am 工具将补丁导入 git 仓库,先导航到包含 git 仓库的目录,然后使用 aerc 的管道命令将选中的邮件导入 git am,也可以一次导入多个补丁,导入后可在新终端中更仔细地审查。应用完满意的补丁后,使用 git push 推送上游,并感谢贡献者。
- 处理合并冲突:如果补丁在应用时出现冲突,可以使用 git am -3 进行三方合并,git 会自动解决简单冲突,留下其他冲突供手动解决,也可以使用 git am --abort 恢复仓库状态,或者要求贡献者处理并发送新修订。
高级 aerc 使用:
- aerc-patch(7):提供了本地管理补丁集的额外功能。
- 推荐的快速 git 使用键绑定:可以在 ~/.config/aerc/binds.conf 中添加自定义键绑定,如 ga 用于应用并标记邮件,gp 用于运行 git push,gl 用于浏览 git log。
- 回复“感谢!”:可以使用模板回复感谢贡献者,并添加相应的键绑定。
- 进一步资源:提供了相关的文章、视频和其他工具的资源,如 git send-email、用于 Linux 内核黑客的电子邮件客户端信息、Drew DeVault 的视频和 Greg K-H 的视频以及 b4 工具。
**粗体** _斜体_ [链接](http://example.com) `代码` - 列表 > 引用
。你还可以使用@
来通知其他用户。