162306a36Sopenharmony_ci.. SPDX-License-Identifier: GPL-2.0 262306a36Sopenharmony_ci 362306a36Sopenharmony_ci.. include:: ../disclaimer-zh_CN.rst 462306a36Sopenharmony_ci 562306a36Sopenharmony_ci:Original: Documentation/doc-guide/maintainer-profile.rst 662306a36Sopenharmony_ci 762306a36Sopenharmony_ci:译者: 吴想成 Wu XiangCheng <bobwxc@email.cn> 862306a36Sopenharmony_ci 962306a36Sopenharmony_ci文档子系统维护人员条目概述 1062306a36Sopenharmony_ci========================== 1162306a36Sopenharmony_ci 1262306a36Sopenharmony_ci文档“子系统”是内核文档和相关基础设施的中心协调点。它涵盖了 Documentation/ 下 1362306a36Sopenharmony_ci的文件层级(Documentation/devicetree 除外)、scripts/ 下的各种实用程序,并且 1462306a36Sopenharmony_ci在某些情况下的也包括 LICENSES/ 。 1562306a36Sopenharmony_ci 1662306a36Sopenharmony_ci不过值得注意的是,这个子系统的边界比通常更加模糊。许多其他子系统维护人员需要 1762306a36Sopenharmony_ci保持对 Documentation/ 某些部分的控制,以便于可以更自由地做更改。除此之外, 1862306a36Sopenharmony_ci许多内核文档都以kernel-doc注释的形式出现在源代码中;这些注释通常(但不总是) 1962306a36Sopenharmony_ci由相关的子系统维护人员维护。 2062306a36Sopenharmony_ci 2162306a36Sopenharmony_ci文档子系统的邮件列表是<linux-doc@vger.kernel.org>。 2262306a36Sopenharmony_ci补丁应尽量针对docs-next树。 2362306a36Sopenharmony_ci 2462306a36Sopenharmony_ci提交检查单补遗 2562306a36Sopenharmony_ci-------------- 2662306a36Sopenharmony_ci 2762306a36Sopenharmony_ci在进行文档更改时,您应当构建文档以测试,并确保没有引入新的错误或警告。生成 2862306a36Sopenharmony_ciHTML文档并查看结果将有助于避免对文档渲染结果的不必要争执。 2962306a36Sopenharmony_ci 3062306a36Sopenharmony_ci开发周期的关键节点 3162306a36Sopenharmony_ci------------------ 3262306a36Sopenharmony_ci 3362306a36Sopenharmony_ci补丁可以随时发送,但在合并窗口期间,响应将比通常慢。文档树往往在合并窗口打开 3462306a36Sopenharmony_ci之前关闭得比较晚,因为文档补丁导致回归的风险很小。 3562306a36Sopenharmony_ci 3662306a36Sopenharmony_ci审阅节奏 3762306a36Sopenharmony_ci-------- 3862306a36Sopenharmony_ci 3962306a36Sopenharmony_ci我(译注:指Jonathan Corbet <corbet@lwn.net>)是文档子系统的唯一维护者,我在 4062306a36Sopenharmony_ci自己的时间里完成这项工作,所以对补丁的响应有时会很慢。当补丁被合并时(或当我 4162306a36Sopenharmony_ci决定拒绝合并补丁时),我都会发送通知。如果您在发送补丁后一周内没有收到回复, 4262306a36Sopenharmony_ci请不要犹豫,发送提醒就好。 4362306a36Sopenharmony_ci 44