Linux Documentation
 help / color / mirror / Atom feed
From: Weijie Yuan <wy@wyuan.org>
To: Alex Shi <seakeel@gmail.com>
Cc: Alex Shi <alexs@kernel.org>, Yanteng Si <si.yanteng@linux.dev>,
	Dongliang Mu <dzm91@hust.edu.cn>,
	Jonathan Corbet <corbet@lwn.net>,
	Shuah Khan <skhan@linuxfoundation.org>,
	Randy Dunlap <rdunlap@infradead.org>,
	Wu XiangCheng <bobwxc@email.cn>,
	linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org
Subject: Re: [PATCH] docs/zh_CN: update maintainer/configure-git.rst translation
Date: Mon, 24 Aug 2026 13:47:19 +0800	[thread overview]
Message-ID: <aova5zNnu4tGHeRJ@wyuan.org> (raw)
In-Reply-To: <6c674f81-35ca-4074-b22a-b9ed6122ce6c@gmail.com>

On Mon, Aug 24, 2026 at 09:59:47AM +0800, Alex Shi wrote:
> 
> 
> On 2026/8/23 23:13, Weijie Yuan wrote:
> > Upstream documented the common 'git tag -s' workflow and cleaned up
> > unneeded RST markup. It briefly updated the automatic lore Link: hook
> > for Git 2.41 and HTTPS, then removed that guidance because Link: tags
> > should only point to useful additional information.
> > 
> > Add a SPDX-License-Identifier.
> > 
> > Remove a useless top-of-file label, as Jon always tries to do.
> > 
> > Update the translation through commit 944df7a31452
> > ("docs: update the guidance for Link: tags").
> > 
> > Signed-off-by: Weijie Yuan<wy@wyuan.org>
> > ---
> > Hi Jon, I added a SPDX-License-Identifier for this file while the
> > original English one doesn't have one yet. Should I do that? / Is it
> > "legal" to do so? , if XiangCheng would be happy with what I'm doing.
> > 
> 
> I am not Jon. but usually changes should start from the original file. we
> don't add or change anything different from it.

Thanks, Alex. The reason why I asked Jon is because I have witnessed him
make some comments on this matter several times. And of course, you also
have much more experience. ;-)

And it seems that I haven't quite figured out how to handle this
identifier in different situations for our translation.

I also asked this question on another topic. The original English text
at that time did not have this identifier, but the Chinese translation
added it:

Quote [1]:

| The SPDX identifier of this translation was added at its birth, while
| the SPDX identifier of its original English version was added this year
| 2026. Although it has been added, I'm quite curious about whether it is
| "legal" to add the identifier on top of the Chinese translation while
| the English original does not have one back in 2023.
| 
| I know Jon has been a little bit careful about it, so I'd better leave
| my thoughts here for future reference.
| 
| Thanks.

Also, I need to take a closer look at the description of this
identifier.

Ultimately, however, I agree that our top principle should be to
maintain consistency with the original text.

Thanks!

[1] https://lore.kernel.org/linux-doc/20260823-maintainer-pgp-guide-v2-3-bea33b2ece54@wyuan.org/

  reply	other threads:[~2026-08-24  5:47 UTC|newest]

Thread overview: 5+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2026-08-23 15:13 [PATCH] docs/zh_CN: update maintainer/configure-git.rst translation Weijie Yuan
2026-08-24  1:59 ` Alex Shi
2026-08-24  5:47   ` Weijie Yuan [this message]
2026-08-24 13:20 ` Jonathan Corbet
2026-08-24 13:32   ` 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=aova5zNnu4tGHeRJ@wyuan.org \
    --to=wy@wyuan.org \
    --cc=alexs@kernel.org \
    --cc=bobwxc@email.cn \
    --cc=corbet@lwn.net \
    --cc=dzm91@hust.edu.cn \
    --cc=linux-doc@vger.kernel.org \
    --cc=linux-kernel@vger.kernel.org \
    --cc=rdunlap@infradead.org \
    --cc=seakeel@gmail.com \
    --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