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

[Dongliang Mu <dzm91@hust.edu.cn>]

On 8/21/26 3:22 PM, Weijie Yuan wrote:
> 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?

My suggestion is to keep the log in each file, and you can easily 
observe the diff. Otherwise, even I can ignore some warnings.

And many contributors are coming together to fix those warnings. If they 
are done, all new warnings are easily captured. Let us do more 
contribution to help this.

Dongliang Mu

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

That change can fix problem. The underlying problem is RST syntax. Maybe 
you can have a look at this or query it in the LLM.

Dongliang Mu

>
> 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.