LWN：内存管理的文档工作以及开发流程！

关注了就能看到更多这么棒的文章哦～

Memory-management documentation and development process

By Jonathan Corbet
June 2, 2023
LSFMM+BPF
DeepL assisted translation
https://lwn.net/Articles/932398/

随着 2023 年 Linux 存储、文件系统、内存管理和 BPF 峰会接近尾声，在内存管理方向举行了两场针对流程上的主题会议。Mike Rapoport 主持了一个关于内存管理文档（或者说缺乏文档）主题的会议，而 Andrew Morton 则介绍了这个子系统开发流程的总体状态。这两个会议都相对简短，并没有提出要进行什么重大改动。

Documentation

Rapoport 首先介绍说文档已经成为一个年度话题。自去年的会议以来，已经取得了一些重大进展：Matthew Wilcox 在内存管理文档中增加了一个目录，Rapoport 贡献了“半个章节”。这一重大进步得到了小组成员们的掌声。Rapoport 以更严肃的语气询问了明年有什么办法可以给出更好的进展。

编者认为有必要指出，尽管有成千上万的内核开发人员被付钱贡来献代码，但没有一个人由于文档贡献而拿到报酬。许多开发人员尝试做了相当多的文档工作，但它几乎总是必须伴随在在人们的有酬劳的“实际”工作中。只要这种情况一直是这样，就很难看到文档上的重大改进。Matthew Wilcox 评论说，这是我们每天看到的那种“endemic corporate brokenness”的一个例子。

Steve Rostedt 建议拒绝那些接受未附带相关文档的 patch;Rapoport 回答说，这种方法无助于解决社区现存的大量缺失文档。Rostedt 说，可以尝试某种 “在你完成某些文档后我们会接受这个 patch”的策略，但 Pasha Tatashin 指出，并不是每个人都是一个好作家，这种政策最终产出可能不符合社区的偏好。

Lorenzo Stoakes 说，写作者也必须是工程师才能正确完成这项工作。Vlastimil Babka 指出，公司喜欢拥有漂亮的技术博客，也许可以将一些精力投入到创建文档中。Seongjae Park 建议使用 ChatGPT。但似乎没有人有任何想法能够大大改善这种情况。

随着会议接近尾声，有人询问 Rapoport 最需要改进的文档在哪里。他回答说，潜在贡献者应该在当前的目录中找到一个感兴趣的缺失内容并填写。

自会议结束以来，Stoakes 正在写一本关于 Linux 内存管理的书，他提出将其中的一部分贡献给内核的文档。这一讨论才刚刚开始，但它很可能在不远的将来引出一些重大贡献。

The state of the community

内存管理方向安排的最后一个会议是传统节目，也就是与维护者 Andrew Morton 进行有关整个社区状态的讨论。他没什么好说的。他去年所提出的一切，包括改用 Git 以及改变 patch 在通往 mainline 的过程中的处理方式，都在按预期工作。mm-stable 这个 subtree 也许是最不成功的部分，因为 patch 需要很长时间才能稳定下来。相应地，他也在越来越积极地催促人们。他还开始将一些未完成的 patch 放入 mm-stable 中，以促进它们的稳定过程。

当被问及他是否计划终结 mm-stable 时，他的回答是“不”，但他会尝试更快地将东西从 unstable tree 中移出。他说，在开发周期的最后一周会有很多东西走进 stable tree，这不是一个理想过程。

Michal Hocko 说，他喜欢过去一年的流程改进。它更加透明了，是朝着正确方向迈出的一步。没有其他人要补充，所以会议在几分钟后就结束了。

全文完
LWN 文章遵循 CC BY-SA 4.0 许可协议。

欢迎分享、转载及基于现有协议再创作～

长按下面二维码关注，关注 LWN 深度文章以及开源社区的各种新近言论～