1*91643abaSWu XiangCheng.. include:: ../disclaimer-zh_CN.rst 2*91643abaSWu XiangCheng 3*91643abaSWu XiangCheng:Original: Documentation/maintainer/maintainer-entry-profile.rst 4*91643abaSWu XiangCheng 5*91643abaSWu XiangCheng:译者: 6*91643abaSWu XiangCheng 7*91643abaSWu XiangCheng 吴想成 Wu XiangCheng <bobwxc@email.cn> 8*91643abaSWu XiangCheng 9*91643abaSWu XiangCheng.. _maintainerentryprofile_zh: 10*91643abaSWu XiangCheng 11*91643abaSWu XiangCheng维护者条目概要 12*91643abaSWu XiangCheng============== 13*91643abaSWu XiangCheng 14*91643abaSWu XiangCheng维护人员条目概要补充了顶层过程文档(提交补丁,提交驱动程序……),增加了子系 15*91643abaSWu XiangCheng统/设备驱动程序本地习惯以及有关补丁提交生命周期的相关内容。贡献者使用此文档 16*91643abaSWu XiangCheng来调整他们的期望和避免常见错误;维护人员可以使用这些信息超越子系统层面查看 17*91643abaSWu XiangCheng是否有机会汇聚到通用实践中。 18*91643abaSWu XiangCheng 19*91643abaSWu XiangCheng 20*91643abaSWu XiangCheng总览 21*91643abaSWu XiangCheng---- 22*91643abaSWu XiangCheng 23*91643abaSWu XiangCheng提供了子系统如何操作的介绍。MAINTAINERS文件告诉了贡献者应发送某文件的补丁到哪, 24*91643abaSWu XiangCheng但它没有传达其他子系统的本地基础设施和机制以协助开发。 25*91643abaSWu XiangCheng 26*91643abaSWu XiangCheng请考虑以下问题: 27*91643abaSWu XiangCheng 28*91643abaSWu XiangCheng- 当补丁被本地树接纳或合并到上游时是否有通知? 29*91643abaSWu XiangCheng- 子系统是否使用patchwork实例?Patchwork状态变更是否有通知? 30*91643abaSWu XiangCheng- 是否有任何机器人或CI基础设施监视列表,或子系统是否使用自动测试反馈以便把 31*91643abaSWu XiangCheng 控接纳补丁? 32*91643abaSWu XiangCheng- 被拉入-next的Git分支是哪个? 33*91643abaSWu XiangCheng- 贡献者应针对哪个分支提交? 34*91643abaSWu XiangCheng- 是否链接到其他维护者条目概要?例如一个设备驱动可能指向其父子系统的条目。 35*91643abaSWu XiangCheng 这使得贡献者意识到某维护者可能对提交链中其他维护者负有的义务。 36*91643abaSWu XiangCheng 37*91643abaSWu XiangCheng 38*91643abaSWu XiangCheng提交检查单补遗 39*91643abaSWu XiangCheng-------------- 40*91643abaSWu XiangCheng 41*91643abaSWu XiangCheng列出强制性和咨询性标准,超出通用标准“提交检查表,以便维护者检查一个补丁是否 42*91643abaSWu XiangCheng足够健康。例如:“通过checkpatch.pl,没有错误、没有警告。通过单元测试详见某处”。 43*91643abaSWu XiangCheng 44*91643abaSWu XiangCheng提交检查单补遗还可以包括有关硬件规格状态的详细信息。例如,子系统接受补丁之前 45*91643abaSWu XiangCheng是否需要考虑在某个修订版上发布的规范。 46*91643abaSWu XiangCheng 47*91643abaSWu XiangCheng 48*91643abaSWu XiangCheng开发周期的关键日期 49*91643abaSWu XiangCheng------------------ 50*91643abaSWu XiangCheng 51*91643abaSWu XiangCheng提交者常常会误以为补丁可以在合并窗口关闭之前的任何时间发送,且下一个-rc1时仍 52*91643abaSWu XiangCheng可以。事实上,大多数补丁都需要在下一个合并窗口打开之前提前进入linux-next中。 53*91643abaSWu XiangCheng向提交者澄清关键日期(以-rc发布周为标志)以明确什么时候补丁会被考虑合并以及 54*91643abaSWu XiangCheng何时需要等待下一个-rc。 55*91643abaSWu XiangCheng 56*91643abaSWu XiangCheng至少需要讲明: 57*91643abaSWu XiangCheng 58*91643abaSWu XiangCheng- 最后一个可以提交新功能的-rc: 59*91643abaSWu XiangCheng 针对下一个合并窗口的新功能提交应该在此点之前首次发布以供考虑。在此时间点 60*91643abaSWu XiangCheng 之后提交的补丁应该明确他们的目标为下下个合并窗口,或者给出应加快进度被接受 61*91643abaSWu XiangCheng 的充足理由。通常新特性贡献者的提交应出现在-rc5之前。 62*91643abaSWu XiangCheng 63*91643abaSWu XiangCheng- 最后合并-rc:合并决策的最后期限。 64*91643abaSWu XiangCheng 向贡献者指出尚未接受的补丁集需要等待下下个合并窗口。当然,维护者没有义务 65*91643abaSWu XiangCheng 接受所有给定的补丁集,但是如果审阅在此时间点尚未结束,那么希望贡献者应该 66*91643abaSWu XiangCheng 等待并在下一个合并窗口重新提交。 67*91643abaSWu XiangCheng 68*91643abaSWu XiangCheng可选项: 69*91643abaSWu XiangCheng 70*91643abaSWu XiangCheng- 开发基线分支的首个-rc,列在概述部分,视为已为新提交做好准备。 71*91643abaSWu XiangCheng 72*91643abaSWu XiangCheng 73*91643abaSWu XiangCheng审阅节奏 74*91643abaSWu XiangCheng-------- 75*91643abaSWu XiangCheng 76*91643abaSWu XiangCheng贡献者最担心的问题之一是:补丁集已发布却未收到反馈,应在多久后发送提醒。除了 77*91643abaSWu XiangCheng指定在重新提交之前要等待多长时间,还可以指示更新的首选样式;例如,重新发送 78*91643abaSWu XiangCheng整个系列,或私下发送提醒邮件。本节也可以列出本区域的代码审阅方式,以及获取 79*91643abaSWu XiangCheng不能直接从维护者那里得到的反馈的方法。 80*91643abaSWu XiangCheng 81*91643abaSWu XiangCheng 82*91643abaSWu XiangCheng现有概要 83*91643abaSWu XiangCheng-------- 84*91643abaSWu XiangCheng 85*91643abaSWu XiangCheng这里列出了现有的维护人员条目概要;我们可能会想要在不久的将来做一些不同的事情。 86*91643abaSWu XiangCheng 87*91643abaSWu XiangCheng.. toctree:: 88*91643abaSWu XiangCheng :maxdepth: 1 89*91643abaSWu XiangCheng 90*91643abaSWu XiangCheng ../doc-guide/maintainer-profile 91*91643abaSWu XiangCheng ../../../nvdimm/maintainer-entry-profile 92*91643abaSWu XiangCheng ../../../riscv/patch-acceptance 93