英语
文档子系统维护者入口配置文件¶
文档“子系统”是内核文档和相关基础设施的中心协调点。它涵盖了 Documentation/ 下的层次结构(除了 Documentation/devicetree),scripts/ 下的各种实用程序,以及至少在某些时候的 LICENSES/。
值得注意的是,此子系统的边界比正常的要模糊得多。许多其他子系统维护者喜欢控制 Documentation/ 的一部分,并且当方便时,更多人会自由地应用更改。除此之外,内核的大部分文档都以 kerneldoc 注释的形式存在于源代码中;这些通常(但不总是)由相关的子系统维护者维护。
文档的邮件列表是 linux-doc@vger.kernel.org。补丁应尽可能针对 docs-next 树进行制作。
提交清单附录¶
在进行文档更改时,您实际上应该构建文档并确保没有引入新的错误或警告。生成 HTML 文档并查看结果将有助于避免对事物如何呈现产生难看的误解。
所有新文档(包括对现有文档的补充)都应该在变更日志中的某个位置说明预期目标受众是谁;这样,我们确保文档最终出现在正确的位置。一些可能的类别是:内核开发人员(专家或初学者)、用户空间程序员、最终用户和/或系统管理员以及发行商。
关键周期日期¶
可以随时发送补丁,但在合并窗口期间,响应速度会比平时慢。由于文档补丁导致回归的风险较低,因此文档树往往在合并窗口打开之前关闭较晚。
审查节奏¶
我是文档子系统的唯一维护者,我正在利用自己的时间进行这项工作,因此对补丁的响应偶尔会很慢。我尽量在合并补丁(或当我决定不能合并补丁时)始终发送通知。如果您在发送补丁后一周内没有收到回复,请不要犹豫发送 ping。