[PATCH v2 2/4] docs/zh_CN: translate generated-content.rst

From: Dongliang Mu

Date: Mon Nov 09 2026 - 00:25:50 EST


Translate the tool-generated content guidelines into Chinese.

Update the translation through commit d699a5da1039
("docs: link AI coding assistants and tool-generated content pages")

Signed-off-by: Dongliang Mu <dzm91@xxxxxxxxxxx>
Reviewed-by: Weijie Yuan <wy@xxxxxxxxx>
---
v1->v2: add the missing Signed-off-by and Reviewed-by tags

.../zh_CN/process/generated-content.rst | 97 +++++++++++++++++++
1 file changed, 97 insertions(+)
create mode 100644 Documentation/translations/zh_CN/process/generated-content.rst

diff --git a/Documentation/translations/zh_CN/process/generated-content.rst b/Documentation/translations/zh_CN/process/generated-content.rst
new file mode 100644
index 000000000000..0dfc02018eb9
--- /dev/null
+++ b/Documentation/translations/zh_CN/process/generated-content.rst
@@ -0,0 +1,97 @@
+.. SPDX-License-Identifier: GPL-2.0
+
+.. include:: ../disclaimer-zh_CN.rst
+
+:翻译:
+ - 慕冬亮 Dongliang Mu <dzm91@xxxxxxxxxxx>
+
+========================
+工具生成内容的内核准则
+========================
+
+目的
+====
+
+内核贡献者早已使用工具生成贡献。这些工具能够增加贡献的数量。与此同时,
+审阅者和维护者的精力有限。了解一份贡献中的哪些部分由人编写、哪些部分
+由工具生成,有助于合理使用这些精力,保持内核开发的健康发展。
+
+本文旨在阐明社区对工具的期望,让大家提高效率,同时维持投稿者与审阅者
+之间的高度信任。
+
+适用范围之外
+============
+
+以下准则不适用于仅对已有内容作细微修改的工具,也不涉及协助处理简单
+事务的工具。例如:
+
+ - 拼写和语法修正,例如改用祈使句
+ - 输入辅助,例如补全标识符、常见样板代码或简单模式
+ - 纯机械式转换,例如重命名变量
+ - 格式调整,例如运行 Lindent、``clang-format`` 或 ``rust-fmt``
+
+即使所用工具不在本文适用范围内,仍应考虑:告知审阅者所用的工具,是否
+有助于他们审阅你的贡献。
+
+适用范围
+========
+
+如果内核贡献中有相当一部分内容并非由 Signed-off-by 签名链中的人编写,
+而是由工具生成,则适用以下准则。
+
+发现问题并测试修复也是开发流程的一部分。如果使用工具发现了一项变更所
+修复的问题,应在变更日志中注明。这既是对工具的认可,也能帮助其他开发者
+了解这些工具。
+
+例如:
+
+ - 工具建议的任何修复,例如 ``checkpatch.pl --fix``
+ - Coccinelle 脚本
+ - 聊天机器人生成了补丁中用于对列表条目排序的新函数
+ - 补丁中的 .c 文件最初由编程助手生成,之后经人工整理
+ - 将补丁交给生成式 AI 工具,由它编写变更日志
+ - 从另一种语言翻译变更日志
+
+如果不能确定,请选择公开透明,假定这些准则适用。
+
+准则
+====
+
+首先,阅读开发者来源认证:
+Documentation/translations/zh_CN/process/submitting-patches.rst。
+它的规则简单,长期以来涵盖了许多工具生成的贡献。请确保自己理解提交的
+全部内容,并准备好回应审阅意见。
+
+其次,投稿时应在封面信和变更日志中如实说明内容的来源。可以提供如下信息,
+使说明更加透明:
+
+ - 使用了哪些工具?
+ - 这些工具的输入是什么,例如 Coccinelle 源脚本?
+ - 如果代码主要根据一条或几条简短提示词生成,请附上这些提示词。
+ 如果会话较长,请概述提示词和由此获得的辅助。
+ - 内容中的哪些部分受到该工具影响?
+ - 如何测试投稿内容,使用了哪些工具测试修复?
+
+与所有贡献一样,各位维护者可自行决定如何处理投稿。例如,他们可能:
+
+ - 将其视为普通贡献;
+ - 直接拒绝;
+ - 特殊处理,例如要求额外测试、更加严格地审阅,或给予低于人工
+ 编写内容的审阅优先级;
+ - 要求其他特殊步骤,例如请贡献者详细说明工具或模型如何训练;
+ - 请投稿者更详细地解释贡献,以确认投稿者充分理解代码的工作方式;
+ - 建议更好的提示词,而不是提出具体的代码修改建议。
+
+如果工具允许你自动生成贡献,应预期生成内容越多,审阅就越严格。
+
+与任何工具的输出一样,结果可能有误或不合适。你应理解并能够为提交的
+所有内容作出解释。如果做不到,就不要提交生成的变更。
+
+如果仍然提交,维护者有权不作详细审阅而拒绝整个补丁集。
+
+参考资料
+========
+
+有关 AI 编程助手的具体准则,参见:
+
+* Documentation/translations/zh_CN/process/coding-assistants.rst
--
2.51.0