Re: [PATCH 0/3] docs/zh_TW: mark translations that are not kept in sync

[Weijie Yuan]

On 2026-09-29 21:11:37 +0800, Chen-Yu Yeh <chenyou910331@xxxxxxxxx> wrote:

> As agreed in the zh_TW scope discussion [1], process/ is the part of
> zh_TW that is kept current; everything else now says in the file
> itself that nobody keeps it in sync, and points readers at the English
> original.  The rule is per file: the two documents that moved into
> process/ with the relocation series are marked until someone updates
> them.
> 
>   1/3 adds the notice and applies it to those two files
>   2/3 applies it to the other 58 translations (one line each)
>   3/3 links filesystems/ and cpu-freq/, which nothing linked before, via
>       a translated subsystem-apis.rst, as the English tree does
> 
> The notice deliberately has no :orphan: marker: included after
> disclaimer-zh_TW.rst, a second one renders as an empty "orphan" field.
> (Two existing pages already show that field, because something precedes
> the disclaimer include: a stray byte-order mark in
> process/kernel-enforcement-statement.rst and a highlight directive in
> gdb-kernel-debugging.rst.  Not fixed here.)
> 
> One consequence worth knowing: checktransupdate.py reads the "update to
> commit" line of a translation's latest commit only, so any tree-wide
> patch like 2/3 makes it report every touched file as current.  The
> contact-block cleanup already had that effect on most of the tree.
> Fixing it belongs in the tool, not in the translations.

Agreed.

> This applies on top of the relocation series sent alongside it,
> "[PATCH 0/4] docs/zh_TW: relocate translations to follow the English
> layout".

I figured out the applying sequence by myself and then came across this
sentence... :-| ;-)

Thanks.