mirror of https://lore.kernel.org/lkml/
 help / color / mirror / Atom feed
From: Dongliang Mu <dzm91@hust.edu.cn>
To: Alex Shi <alexs@kernel.org>, Yanteng Si <si.yanteng@linux.dev>,
	Jonathan Corbet <corbet@lwn.net>,
	linux-doc@vger.kernel.org
Cc: Shuah Khan <skhan@linuxfoundation.org>,
	Randy Dunlap <rdunlap@infradead.org>,
	linux-kernel@vger.kernel.org
Subject: [PATCH v2 2/4] docs/zh_CN: translate generated-content.rst
Date: Mon,  9 Nov 2026 13:21:38 +0800	[thread overview]
Message-ID: <690983f220dde2f52e3522e4d204fd3696d2648d.1794197977.git.dzm91@hust.edu.cn> (raw)
In-Reply-To: <cover.1794197977.git.dzm91@hust.edu.cn>

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@hust.edu.cn>
Reviewed-by: Weijie Yuan <wy@wyuan.org>
---
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@hust.edu.cn>
+
+========================
+工具生成内容的内核准则
+========================
+
+目的
+====
+
+内核贡献者早已使用工具生成贡献。这些工具能够增加贡献的数量。与此同时,
+审阅者和维护者的精力有限。了解一份贡献中的哪些部分由人编写、哪些部分
+由工具生成,有助于合理使用这些精力,保持内核开发的健康发展。
+
+本文旨在阐明社区对工具的期望,让大家提高效率,同时维持投稿者与审阅者
+之间的高度信任。
+
+适用范围之外
+============
+
+以下准则不适用于仅对已有内容作细微修改的工具,也不涉及协助处理简单
+事务的工具。例如:
+
+ - 拼写和语法修正,例如改用祈使句
+ - 输入辅助,例如补全标识符、常见样板代码或简单模式
+ - 纯机械式转换,例如重命名变量
+ - 格式调整,例如运行 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


  parent reply	other threads:[~2026-11-09  5:21 UTC|newest]

Thread overview: 20+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2026-11-08 16:06 [PATCH 0/4] docs/zh_CN: translate AI-related process guides Dongliang Mu
2026-11-08 16:06 ` [PATCH 1/4] docs/zh_CN: translate coding-assistants.rst Dongliang Mu
2026-11-09  3:06   ` Weijie Yuan
2026-11-09  3:18     ` Weijie Yuan
2026-11-09  3:23       ` Dongliang Mu
2026-11-09  4:09       ` Dongliang Mu
2026-11-09  0:44 ` [PATCH 0/4] docs/zh_CN: translate AI-related process guides Weijie Yuan
2026-11-09  2:20   ` Dongliang Mu
2026-11-09  1:39 ` [PATCH 2/4] docs/zh_CN: translate generated-content.rst Dongliang Mu
2026-11-09  3:19   ` Weijie Yuan
2026-11-09  1:39 ` [PATCH 3/4] docs/zh_CN: translate threat-model.rst Dongliang Mu
2026-11-09  3:20   ` Weijie Yuan
2026-11-09  1:39 ` [PATCH 4/4] docs/zh_CN: link AI guide to translated documents Dongliang Mu
2026-11-09  3:24   ` Weijie Yuan
2026-11-09  5:21 ` [PATCH v2 0/4] docs/zh_CN: translate AI-related process guides Dongliang Mu
2026-11-09  5:21   ` [PATCH v2 1/4] docs/zh_CN: translate coding-assistants.rst Dongliang Mu
2026-11-09  5:21   ` Dongliang Mu [this message]
2026-11-09  5:21   ` [PATCH v2 3/4] docs/zh_CN: translate threat-model.rst Dongliang Mu
2026-11-09  5:21   ` [PATCH v2 4/4] docs/zh_CN: link AI guide to translated documents Dongliang Mu
2026-11-09 13:32   ` [PATCH v2 0/4] docs/zh_CN: translate AI-related process guides Weijie Yuan

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=690983f220dde2f52e3522e4d204fd3696d2648d.1794197977.git.dzm91@hust.edu.cn \
    --to=dzm91@hust.edu.cn \
    --cc=alexs@kernel.org \
    --cc=corbet@lwn.net \
    --cc=linux-doc@vger.kernel.org \
    --cc=linux-kernel@vger.kernel.org \
    --cc=rdunlap@infradead.org \
    --cc=si.yanteng@linux.dev \
    --cc=skhan@linuxfoundation.org \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox

all inboxes | Powered by JetHome®