13、技术基础设施建设指南

技术基础设施建设指南

1. 提交列表订阅

鼓励开发者订阅提交列表，这是在代码层面跟进项目动态最有效的方式。提交邮件不仅能带来同行评审的技术优势，还有助于营造社区氛围，因为它创建了一个共享环境，让人们能对其他人也能看到的事件做出反应。

项目应根据开发者群体的特点，决定使用邮件列表还是其他可订阅的通知论坛。若不确定，邮件通常是不错的默认选择。设置通知的具体方式会因版本控制系统而异，但一般都有相应的脚本或工具。若难以找到，可查找关于钩子（或触发器）的文档，特别是合并后钩子或提交后钩子，这些钩子可用于在接收到更改时启动自动化任务，例如发送邮件。

对于预打包的提交邮件系统，可能需要修改一些默认行为：
1. 包含实际差异 ：部分提交邮件不包含实际的差异内容，仅提供一个在网页上查看更改的 URL。虽然提供 URL 方便后续参考，但邮件中包含差异本身也很重要。因为阅读邮件是人们日常的一部分，若更改内容能直接在邮件中看到，开发者可直接在邮件中审查提交，无需点击 URL。此外，若审查者有问题，直接在邮件中回复并注释引用的差异比访问网页并复制粘贴差异内容到邮件客户端要容易得多。不过，若差异内容过大，如仓库中添加了大量新代码，可只提供 URL，多数提交邮件系统能自动进行大小限制。若不能，包含差异内容，忍受偶尔的大邮件，也比完全不包含要好，因为方便的审查和评论是协作开发的基石。
2. 设置回复头 ：提交邮件的回复头应设置为常规的开发列表，而非提交邮件列表。这样，当有人审查提交并回复时，回复会自动定向到开发列表，便于集中讨论技术问题。原因如下：一是将所有技术讨论集中在一个列表，方便人们查找和存档；二是可能有感兴趣