Re: [PATCH] docs/zh_CN: Update arch/riscv/vm-layout.rst translation

[Yukai Wu <xiaoyewuz.ruster@gmail.com>]

On Saturday, August 29, 2026 11:32:02 PM China Standard Time Weijie Yuan 
wrote:
> Hi, it's me again ;-)
> 
> On Sat, Aug 29, 2026 at 12:15:10PM +0800, Yukai Wu wrote:
> > Update Documentation/arch/riscv/vm-layout.rst translation.
> > 
> > Update the translation through commit 954260ff5a46
> > ("Revert "RISC-V: mm: Document mmap changes"")
> 
> Somehow I guess you didn't get the actual meaning behind this "Update xxx
> through commit...".
> 
> Correct me if I'm wrong. If you write this line in your commit message.
> Then it means if we apply this patch of yours. The Chinese documentation
> of this file should be already _completely_ synchronized.
> 

I agree. My fault again.

> However, the current translation of this file is missing this part:
> 
> RISC-V Linux Kernel SV57
> ------------------------
> 
> ... which is not translated/synchronized in your patch.
> 
> 

Didn't see that because I just used the tools/docs/checktransupdate.py script, 
which cannot see the commits before ed843ae947f8 ("docs: move riscv under 
arch"). That commit just moved the Chinese translation but was treated as an 
update by the script. And I only looked at the commits reported by the script.

> Note that I'm not blaming on you for this. But I feel this is a point
> that a newcomer might find confusing, including me and Chen-Yu a couple
> of weeks ago, if did not read the script.
> 
> Our current how-to.rst only asks to write this line in the commit
> message but does not explain the results or the actual work behind it.
> 
> [...]
> 	Update the translation through commit b080e52110ea
> 	("docs: update self-protection __ro_after_init status")
> 	# 请执行 git log --oneline <您翻译的英文文档路径>，并替换上述内容
> 
> 	So when a newcomer comes and just does what this asks, without
> 	considering whether his/her/its translation is completely
> 	synchronized or not, our script would be kind of inaccurate. ?
> 
> Maybe we can add a description or a hint like:
> 
> If your current changes make the translation completely in line with the
> English version, then please add this line after your descriptions and
> before a blank line and your sign-off:
> 
> Update the translation through commit e83c5163316f
> (Initial revision of "git", the information manager from hell)
> 
> ..then follows a template commit message

Allowing partial updates to the translation?

> 
> 
> Any ideas?
> 
> (Should I cc the original authors of the script?)

CC the authors of the checktransupdate.py script?

> 
> Thanks.

Best,
Yukai Wu