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

[Weijie Yuan <wy@wyuan.org>]

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.

However, the current translation of this file is missing this part:

RISC-V Linux Kernel SV57
------------------------

... which is not translated/synchronized in your patch.


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


Any ideas?

(Should I cc the original authors of the script?)

Thanks.