Re: [PATCH 0/4] Update maintainer-pgp-guide.rst Chinese translation

From: Weijie Yuan

Date: Fri Aug 21 2026 - 03:22:34 EST


On Fri, Aug 21, 2026 at 02:54:59PM +0800, Dongliang Mu wrote:
>
> On 8/21/26 1:13 AM, Weijie Yuan wrote:
> > The script says:
> >
> > $ tools/docs/checktransupdate.py Documentation/translations/zh_CN/process/maintainer-pgp-guide.rst
> > [1787244823.341547] Documentation/translations/zh_CN/process/maintainer-pgp-guide.rst
> > [1787244823.630509] commit 54857c52452a ("docs: maintainer-pgp-guide.rst: add a reference for kernel.org sign")
> > [1787244823.680849] commit 6c5c07bc8589 ("docs: process: maintainer-pgp-guide: update kernel.org docs link")
> > [1787244823.730027] commit 273aa250f138 ("Documentation: Improve wording on requirements for a free Nitrokey")
> > [1787244823.779408] commit f44a29784f68 ("Documentation: update maintainer-pgp-guide for latest best practices")
> > [1787244823.779522] 4 commits needs resolving in total
> >
> > So I updated this document in chronological order, created four patches
> > based on these four outdated commits to make it easier for you to
> > review. Hence, you can freely squash them when applying them.
> >
> > Tested with make htmldocs, no warning or error made by these patches.
>
> Hi Weijie,
>
> Please make sure you execute "  make cleandocs & make htmldocs". Some
> warnings may be ignored by further compilation.

Hi!

Thanks for emphasizing this. While I do remember I used "make cleandocs
&& make htmldocs", and checked among those long lines of red warning
output to find anything caused by my commit, I indeed didn't notice this
warning appearing at the early stage of the compilation.

It seems that I need to have my eyes checked soon. ;-)

Apologize for my recklessness.

Even so, do we have any way to distinguish these long-standing warnings
from the new warnings that appear during compilation? In fact, every
time I was worried that I might not have noticed the newly appeared
warning. Unfortunately, this time it really happened. (For example,
setting a new color? for new warnings?) Do you have a better idea or
tips for this?

Btw I've been trying to know more about Sphinx and kernel-docs, hope my
mistake won't happen again.

Thanks.

>   > WARNING: duplicate label kernel_org_trust_repository
>   >
>   > The same label is already defined in the English document. Please use a translation-specific label, for example:
>   >
>   > .. _zh_kernel_org_trust_repository:


>   > checkpatch.pl reports:
>   >
>   > WARNING: Assisted-by expects 'AGENT_NAME:MODEL_VERSION [TOOL1] [TOOL2]' format
>   >
>   > Please replace Assisted-by: LLM with the actual agent, model version, and tools used.

And this one has been updated from Jon's PR last night, so I ignored
this output, left just a simple LLM.