[PATCH v3 0/2] docs/zh_CN: update maintainer/configure-git.rst

[PATCH v3 0/2] docs/zh_CN: update maintainer/configure-git.rst

[Weijie Yuan]

Update the translation of two files:

1) maintainer/configure-git.rst
2) maintainer/pull-requests.rst

I only update the first one in v1. However, I find a reference of
pull-requests.rst in configure-git.rst is in English, while we've had a
Chinese one. So, update both this time.

Note that there're warm tips from checkpatch,

checkpatch.pl: :6: WARNING: 'Link:' should be followed by a public http(s) link
checkpatch.pl: Documentation/translations/zh_CN/maintainer/pull-requests.rst:118: WARNING: Do not use whitespace before Signed-off-by:

.. which are caused by a 'Link:' in the commit message and a sample Sob
trailer.

---
Changes in v3:
- Put "update to commit section" at the end of commit message in both.
- Rebase to d48723711bae (Merge tag 'arm64-fixes' of git://git.kernel.org/pub/scm/linux/kernel/git/arm64/linux, 2026-11-06)
  Alex's docs-next HEAD now.
- Link to v2: https://patch.msgid.link/20260905-configure-git-v2-0-ab194db8c6b9@wyuan.org

Changes in v2:
- Remove the SPDX identifier, see details and reasons in the thread of v1.
- Add a new translation.
- Link to v1: https://patch.msgid.link/20260823-configure-git-v1-1-3c65eefcc585@wyuan.org

To: Alex Shi <alexs@kernel.org>
To: Yanteng Si <si.yanteng@linux.dev>
To: Dongliang Mu <dzm91@hust.edu.cn>
To: Jonathan Corbet <corbet@lwn.net>
To: Shuah Khan <skhan@linuxfoundation.org>
To: Randy Dunlap <rdunlap@infradead.org>
Cc: linux-doc@vger.kernel.org
Cc: linux-kernel@vger.kernel.org

---
Weijie Yuan (2):
      docs/zh_CN: sync maintainer/configure-git with upstream
      docs/zh_CN: improve maintainer/pull-requests translation

 .../zh_CN/maintainer/configure-git.rst             |  48 ++------
 .../zh_CN/maintainer/pull-requests.rst             | 127 +++++++++++----------
 2 files changed, 77 insertions(+), 98 deletions(-)

Range-diff versus v2:

1:  d292fa654b82 ! 1:  a791cc884749 docs/zh_CN: sync maintainer/configure-git with upstream
    @@ Commit message
         adding Link trailers automatically with an applypatch-msg hook, because
         Link: trailers should only point to useful additional information.
     
    +    Also point the pull-request reference to the Chinese translation.
    +
         Update the translation through commit 944df7a31452
         ("docs: update the guidance for Link: tags").
     
    -    Also point the pull-request reference to the Chinese translation.
    -
         Signed-off-by: Weijie Yuan <wy@wyuan.org>
     
      ## Documentation/translations/zh_CN/maintainer/configure-git.rst ##
2:  9ed78fb91f42 ! 2:  2bec387ee1e3 docs/zh_CN: improve maintainer/pull-requests translation
    @@ Commit message
         After the last update to the Chinese translation, the English document
         removed the explicit section label, replaced the configure-git
         cross-reference with a direct path, and changed "tree for forever" to
    -    "tree forever".
    +    "tree forever". Remove the abandoned Chinese section label and point the
    +    configure-git reference to the Chinese translation. Some of the existing
    +    wording did not read very smoothly, so polish a few expressions and also
    +    correct some Git terminology.
     
         Update the translation through commit 3a1b9c4d8edb
         ("docs: Remove redundant word "for"").
     
    -    Remove the abandoned Chinese section label and point the configure-git
    -    reference to the Chinese translation.
    -
    -    Some of the existing wording did not read very smoothly, so polish a few
    -    expressions. And also correct some Git terminology.
    -
         Signed-off-by: Weijie Yuan <wy@wyuan.org>
    -    ---
    -    I did make quite a few changes to make the reading more fluent. However,
    -    to some extent, this might also be unnecessary. If you think there are
    -    too many, I will remove the less essential ones. Thanks.
     
      ## Documentation/translations/zh_CN/maintainer/pull-requests.rst ##
     @@

---
base-commit: d48723711bae9b8cdc56719c448ba42fef28cbee
change-id: 20260823-configure-git-686aea09bf5b

[PATCH v3 1/2] docs/zh_CN: sync maintainer/configure-git with upstream

[Weijie Yuan]

The English document updated the signed-tag instructions to describe
selecting a key with -u <key-id>, configuring a default key, and using
-s. It also removed the explicit section label and the instructions for
adding Link trailers automatically with an applypatch-msg hook, because
Link: trailers should only point to useful additional information.

Also point the pull-request reference to the Chinese translation.

Update the translation through commit 944df7a31452
("docs: update the guidance for Link: tags").

Signed-off-by: Weijie Yuan <wy@wyuan.org>
---
 .../zh_CN/maintainer/configure-git.rst             | 48 +++++-----------------
 1 file changed, 11 insertions(+), 37 deletions(-)

diff --git a/Documentation/translations/zh_CN/maintainer/configure-git.rst b/Documentation/translations/zh_CN/maintainer/configure-git.rst
index a45ea736f73b..693d4e5247a6 100644
--- a/Documentation/translations/zh_CN/maintainer/configure-git.rst
+++ b/Documentation/translations/zh_CN/maintainer/configure-git.rst
@@ -5,58 +5,32 @@
 :译者:
 
  吴想成 Wu XiangCheng <bobwxc@email.cn>
+ 袁维杰 Weijie Yuan <wy@wyuan.org>
 
-.. _configuregit_zh:
+配置 Git
+========
 
-Git配置
-=======
+本章介绍维护者级别的 Git 配置。
 
-本章讲述了维护者级别的git配置。
-
-Documentation/maintainer/pull-requests.rst 中使用的标记分支应使用开发人员的
-GPG公钥进行签名。可以通过将 ``-u`` 标志传递给 ``git tag`` 来创建签名标记。
-但是，由于 *通常* 对同一项目使用同一个密钥，因此可以设置::
+拉取请求中使用的带标签分支（参见 Documentation/translations/zh_CN/maintainer/pull-requests.rst）
+应使用开发者的 GPG 公钥签名。向 ``git tag`` 传递 ``-u <key-id>`` 可以创建签名标签。
+不过，由于你对同一项目 *通常* 会使用同一个密钥，因此可以在配置中设置该密钥并
+使用 ``-s`` 选项。使用以下命令设置默认的 ``key-id``::
 
 	git config user.signingkey "keyname"
 
-或者手动编辑你的 ``.git/config`` 或 ``~/.gitconfig`` 文件::
+也可以手动编辑你的 ``.git/config`` 或 ``~/.gitconfig`` 文件::
 
 	[user]
 		name = Jane Developer
 		email = jd@domain.org
 		signingkey = jd@domain.org
 
-你可能需要告诉 ``git`` 去使用 ``gpg2``::
+你可能需要让 ``git`` 使用 ``gpg2``::
 
 	[gpg]
 		program = /path/to/gpg2
 
-你可能也需要告诉 ``gpg`` 去使用哪个 ``tty`` （添加到你的shell rc文件中）::
+你可能还需要告诉 ``gpg`` 使用哪个 ``tty`` （将其添加到 shell 的 rc 文件中）::
 
 	export GPG_TTY=$(tty)
-
-
-创建链接到lore.kernel.org的提交
--------------------------------
-
-http://lore.kernel.org 网站是所有涉及或影响内核开发的邮件列表的总存档。在这里
-存储补丁存档是推荐的做法，当维护人员将补丁应用到子系统树时，最好提供一个指向
-lore存档链接的标签，以便浏览提交历史的人可以找到某个更改背后的相关讨论和基本
-原理。链接标签如下所示：
-
-	Link: https://lore.kernel.org/r/<message-id>
-
-通过在git中添加以下钩子，可以将此配置为在发布 ``git am`` 时自动执行：
-
-.. code-block:: none
-
-	$ git config am.messageid true
-	$ cat >.git/hooks/applypatch-msg <<'EOF'
-	#!/bin/sh
-	. git-sh-setup
-	perl -pi -e 's|^Message-Id:\s*<?([^>]+)>?$|Link: https://lore.kernel.org/r/$1|g;' "$1"
-	test -x "$GIT_DIR/hooks/commit-msg" &&
-		exec "$GIT_DIR/hooks/commit-msg" ${1+"$@"}
-	:
-	EOF
-	$ chmod a+x .git/hooks/applypatch-msg

-- 
2.56.0.438.g30c3f27cb8

[PATCH v3 2/2] docs/zh_CN: improve maintainer/pull-requests translation

[Weijie Yuan]

After the last update to the Chinese translation, the English document
removed the explicit section label, replaced the configure-git
cross-reference with a direct path, and changed "tree for forever" to
"tree forever". Remove the abandoned Chinese section label and point the
configure-git reference to the Chinese translation. Some of the existing
wording did not read very smoothly, so polish a few expressions and also
correct some Git terminology.

Update the translation through commit 3a1b9c4d8edb
("docs: Remove redundant word "for"").

Signed-off-by: Weijie Yuan <wy@wyuan.org>
---
 .../zh_CN/maintainer/pull-requests.rst             | 127 +++++++++++----------
 1 file changed, 66 insertions(+), 61 deletions(-)

diff --git a/Documentation/translations/zh_CN/maintainer/pull-requests.rst b/Documentation/translations/zh_CN/maintainer/pull-requests.rst
index ce9725f4674c..4509ec2a2bea 100644
--- a/Documentation/translations/zh_CN/maintainer/pull-requests.rst
+++ b/Documentation/translations/zh_CN/maintainer/pull-requests.rst
@@ -5,19 +5,18 @@
 :译者:
 
  吴想成 Wu XiangCheng <bobwxc@email.cn>
-
-.. _pullrequests_zh:
+ 袁维杰 Weijie Yuan <wy@wyuan.org>
 
 如何创建拉取请求
 ================
 
-本章描述维护人员如何创建并向其他维护人员提交拉取请求。这对将更改从一个维护者
-树转移到另一个维护者树非常有用。
+本章介绍维护者如何创建拉取请求并将其提交给其他维护者。这适用于将更改从一棵
+维护者树转移到另一棵维护者树。
 
-本文档由Tobin C. Harding（当时他尚不是一名经验丰富的维护人员）编写，内容主要
-来自Greg Kroah Hartman和Linus Torvalds在LKML上的评论。Jonathan Corbet和Mauro
-Carvalho Chehab提出了一些建议和修改。错误不可避免，如有问题，请找Tobin C.
-Harding <me@tobin.cc>。
+本文档由 Tobin C. Harding（当时他尚不是一名经验丰富的维护者）编写，主要依据
+Greg Kroah-Hartman 和 Linus Torvalds 在 LKML 上的评论。Jonathan Corbet 和
+Mauro Carvalho Chehab 提出了建议和修正。曲解原意并非有意，却在所难免；请将
+责难发送给 Tobin C. Harding <me@tobin.cc>。
 
 原始邮件线程::
 
@@ -27,54 +26,58 @@ Harding <me@tobin.cc>。
 创建分支
 --------
 
-首先，您需要将希望包含拉取请求里的所有更改都放在单独分支中。通常您将基于某开发
-人员树的一个分支，一般是打算向其发送拉取请求的开发人员。
+首先，你需要将希望包含在拉取请求中的所有更改放在一个单独的分支上。通常，这个
+分支会基于你准备向其发送拉取请求的开发者树中的某个分支。
 
-为了创建拉取请求，您必须首先标记刚刚创建的分支。建议您选择一个有意义的标记名，
-以即使过了一段时间您和他人仍能理解的方式。在名称中包含源子系统和目标内核版本
-的指示也是一个好的做法。
+要创建拉取请求，必须先给刚刚创建的分支打标签。建议选择一个有意义的标签名称，
+使你和其他人在一段时间后仍能理解其含义。一种良好做法是在名称中指明来源子系统
+和目标内核版本。
 
-Greg提供了以下内容。对于一个含有drivers/char中混杂事项、将应用于4.15-rc1内核的
-拉取请求，可以命名为 ``char-misc-4.15-rc1`` 。如果要在 ``char-misc-next`` 分支
-上打上此标记，您可以使用以下命令::
+Greg 给出了以下示例。对于一个包含 drivers/char 杂项、准备应用到 4.15-rc1
+内核版本的拉取请求，可以将其命名为 ``char-misc-4.15-rc1``。如果要从名为
+``char-misc-next`` 的分支创建该标签，可以使用以下命令::
 
 	git tag -s char-misc-4.15-rc1 char-misc-next
 
-这将在 ``char-misc-next`` 分支的最后一个提交上创建一个名为 ``char-misc-4.15-rc1``
-的标记，并用您的gpg密钥签名（参见 Documentation/maintainer/configure-git.rst ）。
+该命令会基于 ``char-misc-next`` 分支的最后一个提交创建名为
+``char-misc-4.15-rc1`` 的签名标签，并使用你的 GPG 密钥签名（参见
+Documentation/translations/zh_CN/maintainer/configure-git.rst）。
 
-Linus只接受基于签名过的标记的拉取请求。其他维护者可能会有所不同。
+Linus 只接受基于签名标签的拉取请求。其他维护者的要求可能不同。
 
-当您运行上述命令时 ``git`` 会打开编辑器要求你描述一下这个标记。在本例中您需要
-描述拉取请求，所以请概述一下包含的内容，为什么要合并，是否完成任何测试。所有
-这些信息都将留在标记中，然后在维护者合并拉取请求时保留在合并提交中。所以把它
-写好，它将永远留在内核中。
+运行上述命令时，``git`` 会打开编辑器并要求你描述该标签。在本例中，你描述的是
+一个拉取请求，因此应概述其中包含什么、为何应当合并，以及做过哪些测试（如有）。
+所有这些信息都会保存在标签本身中；如果维护者合并了拉取请求，它们还会进入维护者
+创建的合并提交。因此请认真撰写，因为它将永远保留在内核树中。
 
-正如Linus所说::
+正如 Linus 所说::
 
-	不管怎么样，至少对我来说，重要的是 *信息* 。我需要知道我在拉取什么、
-	为什么我要拉取。我也希望将此消息用于合并消息，因此它不仅应该对我有
-	意义，也应该可以成为一个有意义的历史记录。
+	总之，至少对我而言，重要的是 *说明文字*。我想知道自己
+	正在拉取什么，以及为什么应当拉取。我还希望把这段说明用作合并说明，
+	所以它不但要让我看得明白，还应当能成为有意义的历史记录。
 
-	注意，如果拉取请求有一些不寻常的地方，请详细说明。如果你修改了并非
-	由你维护的文件，请解释 **为什么** 。我总会在差异中看到的，如果你不
-	提的话，我只会觉得分外可疑。当你在合并窗口后给我发新东西的时候，
-	（甚至是比较重大的错误修复），不仅需要解释做了什么、为什么这么做，
-	还请解释一下 **时间问题** 。为什么错过了合并窗口……
+	请注意，如果拉取请求中有什么异常，就非常应该在说明中写清楚。
+	如果你改动了自己并不维护的文件，请解释 _为什么_。无论如何，我会在
+	差异统计中看到它；如果你没提到，我只会更加怀疑。当你在合并窗口
+	结束后给我发送新内容（甚至是错误修复，但看起来很吓人的那种）时，
+	不仅要解释它们做了什么、为什么这样做，还要解释这个 _时机_。
+	发生了什么，导致它没能通过合并窗口进入……
 
-	我会看你写在拉取请求邮件和签名标记里面的内容，所以根据你的工作流，
-	你可以在签名标记里面描述工作内容（也会自动放进拉取请求邮件），也
-	可以只在标记里面放个占位符，稍后在你实际发给我拉取请求时描述工作内容。
+	我会采用你写在拉取请求邮件 _和_ 签名标签中的内容。因此，
+	取决于你的工作流程，你可以在签名标签中描述自己的工作（这些内容也会
+	自动进入拉取请求邮件），也可以让签名标签仅仅作为一个没有实质内容的
+	占位符，等到真正向我发送拉取请求时再描述这项工作。
 
-	是的，我会编辑这些消息。部分因为我需要做一些琐碎的格式调整（整体缩进、
-	括号等），也因为此消息可能对我有意义（描述了冲突或一些个人问题）而对
-	合并提交信息上下文没啥意义，因此我需要尽力让它有意义起来。我也会
-	修复一些拼写和语法错误，特别是非母语者（母语者也是;^）。但我也会删掉
-	或增加一些内容。
+	没错，我会编辑这段说明。一方面是因为我通常会做些简单的格式调整（整体
+	缩进、引用等）；另一方面，其中一些内容在我拉取时可能很有用（例如描述
+	冲突，以及你此时发送请求所面临的个人问题），但放在合并提交说明的上下文
+	中可能没有意义，所以我会尽量使它通顺。我也会修正看到的拼写错误和糟糕
+	语法，尤其是非英语母语者写的内容（英语母语者也一样 ;^）。
+	不过，我也可能会漏掉一些，甚至再添上一些。
 
 			Linus
 
-Greg给出了一个拉取请求的例子::
+Greg 给出了一个拉取请求示例::
 
 	Char/Misc patches for 4.15-rc1
 
@@ -104,9 +107,10 @@ Greg给出了一个拉取请求的例子::
 	Signed-off-by: Your-name-here <your_email@domain>
 
 
-此标记消息格式就像一个git提交。顶部有一行“总结标题”， 一定要在下面sign-off。
+标签说明的格式与 Git 提交说明相同：顶部用一行作为“摘要主题”，
+并确保在底部添加签署信息。
 
-现在您已经有了一个本地签名标记，您需要将它推送到可以被拉取的位置::
+现在本地已有签名标签，需要将其推送到可供拉取的位置::
 
 	git push origin char-misc-4.15-rc1
 
@@ -114,35 +118,36 @@ Greg给出了一个拉取请求的例子::
 创建拉取请求
 ------------
 
-最后要做的是创建拉取请求消息。可以使用 ``git request-pull`` 命令让 ``git``
-为你做这件事，但它需要确定你想拉取什么，以及拉取针对的基础（显示正确的拉取
-更改和变更状态）。以下命令将生成一个拉取请求::
+最后要做的是编写拉取请求消息。``git`` 可以方便地用 ``git request-pull``
+命令代劳，但需要获得一些帮助，以确定你希望对方拉取什么，以及拉取内容应以什么为
+基础（从而显示正确的待拉取更改和差异统计）。以下命令会生成一个拉取请求::
 
 	git request-pull master git://git.kernel.org/pub/scm/linux/kernel/git/gregkh/char-misc.git/ char-misc-4.15-rc1
 
-引用Greg的话::
+引用 Greg 的话::
 
-	此命令要求git比较从“char-misc-4.15-rc1”标记位置到“master”分支头（上述
-	例子中指向了我从Linus的树分叉的地方，通常是-rc发布）的差异，并去使用
-	git:// 协议拉取。如果你希望使用 https:// 协议，也可以用在这里（但是请
-	注意，部分人由于防火墙问题没法用https协议拉取）。
+	这个命令要求 Git 比较“char-misc-4.15-rc1”标签所在位置与“master”分支
+	顶端之间的差异（在我的例子中，“master”指向我与 Linus 的树发生分叉前
+	的最后位置，通常是一个 -rc 版本），并使用 git:// 协议拉取。如果希望使用
+	https://，也可以在这里使用（但请注意，一些位于防火墙后的用户使用 HTTPS
+	方式拉取 Git 仓库时会遇到问题）。
 
-	如果char-misc-4.15-rc1标记没有出现在我要求拉取的仓库中，git会提醒
-	它不在那里，所以记得推送到公开地方。
+	如果请求拉取的仓库中没有“char-misc-4.15-rc1”标签，Git 会抱怨说找不到
+	它。这可以方便地提醒你，确实需要把标签推送到一个公开位置。
 
-	“git request-pull”会包含git树的地址和需要拉取的特定标记，以及标记
-	描述全文（详尽描述标记）。同时它也会创建此拉取请求的差异状态和单个
-	提交的缩短日志。
+	“git request-pull”的输出会包含要拉取的 Git 树位置和具体标签，以及
+	该标签的完整说明文字（这正是需要在标签中提供充分信息的原因）。它还会
+	生成拉取请求的差异统计，以及拉取请求所含各个提交的简短日志。
 
-Linus回复说他倾向于 ``git://`` 协议。其他维护者可能有不同的偏好。另外，请注意
-如果你创建的拉取请求没有签名标记， ``https://`` 可能是更好的选择。完整的讨论
-请看原邮件。
+Linus 回复说他倾向于使用 ``git://`` 协议。其他维护者可能有不同偏好。另请注意，
+如果创建拉取请求时不使用签名标签，那么 ``https://`` 可能是更好的选择。完整讨论
+请参阅原始邮件线程。
 
 
 提交拉取请求
 ------------
 
-拉取请求的提交方式与普通补丁相同。向维护人员发送内联电子邮件并抄送LKML以及
-任何必要特定子系统的列表。对Linus的拉取请求通常有如下主题行::
+拉取请求的提交方式与普通补丁相同。通过邮件正文将其发送给维护者，并视需要抄送
+LKML 和相关子系统的邮件列表。发给 Linus 的拉取请求通常使用类似下面的主题行::
 
 	[GIT PULL] <subsystem> changes for v4.15-rc1

-- 
2.56.0.438.g30c3f27cb8