今日重点:✍️ 写作——内核里最难写的一种 cover letter,不是「加新功能」,而是「删旧代码」。 加功能只要证明「它有用」,删代码要同时证明「它没用」和「删了不会出事」。 Intel 的 Ilpo Järvinen 这封 [PATCH 0/3] PCI: remove redundant resource assignments done after BAR resize 是教科书:三段话、45 个单词的正文,把这两个证明一次做完, 维护者 Bjorn Helgaas 回复一句「All applied to pci/resource for v7.5, thank you!」直接收下。
✍️ 写作:三段式论证逐段拆解
/ section第一段:事实陈述,不带判断。原文:「The BAR resize rework removed the resource assignment call that followed the BAR resize in amdgpu. The xe and i915 drivers and the PCI sysfs resize interface still make the same call.」两句对仗:前一句说 amdgpu 已经删了, 后一句说 xe / i915 / sysfs 还在做同样的事。注意作者没有说「这三个地方写错了」, 只用了中性的「still make the same call」——把「该不该删」的判断留给读者,自己只摆事实。 这是技术写作里的低成本开局:先建立共识,再推进论证。
第二段:论点 + 可证伪边界。原文:「The current BAR resize code should properly assign all resources and handle fallback gracefully so a driver-side call to assign resource right after BAR resize is just duplicate work (no-op). If that isn't the case somewhere, the fix belongs either the BAR resize code or the code that left the resource unassigned (e.g. a hotplug race or whatever left an resource unassigned prior to resize).」前一句给论点:driver 侧的调用 是 no-op。后一句是这封信最妙的地方——作者主动承认「如果某处不成立」, 并且立刻指出「那也说明 bug 在别处(BAR resize 代码本身,或之前漏分配的那段),不在这封信删掉的 这行」。这叫可证伪的论证(falsifiable argument):不是「相信我」,而是「如果我错, 错在哪里、由谁负责」都提前讲清楚。维护者看到这一句,review 的兜底成本就被作者主动接了。
第三段:后勤安排,一句话。原文:「If drm wants to take their patches out of these, it's fine with me (either drm+pci or through pci tree only works for me).」跨子系统的 patch 永远有一个隐形问题——「这封走哪棵树?」作者不等问题被问出来,先一句话把两条路径(drm+pci 分别合,或整体走 pci 树)都摆出来,并明确表态「我都行」。这是给维护者减负的写法: 你替他把选项和取舍都想好了,他只要回一个「pci only」就完事。
三段式总结成一张卡:① 事实(无判断)→ ② 论点 + 可证伪边界 → ③ 后勤安排。 整个正文 45 个英文单词,对应 6 行代码删除。密度才是这封 cover letter 真正厉害 的地方——没有一句客套、没有一句背景科普、没有一句「请大家多指教」。每个句子都在为「让维护者 少花一分钟」服务。
✨ 辅助彩蛋:维护者怎么回
/ sectionBjorn Helgaas 的回复只有一句:「All applied to pci/resource for v7.5, thank you!」 三个信息一个不漏——收了(All applied)、收在哪(pci/resource 分支)、 目标是哪个版本(v7.5)。这是 maintainer 侧的标准「收下确认」写法,你下次收到 这种一句话回复,就知道背后意味着 patch 已经进入维护者队列、等下个 merge window。
✍️ 今日练习
/ section💡 显示答案
删代码的 cover letter:先证它没用,再证删了不出事。
素材:linux-pci · Ilpo Järvinen · 2026-11-09