Re: [PATCH 2/3] docs/zh_TW: mark translations outside the maintained set

From: Weijie Yuan

Date: Sat Oct 03 2026 - 00:53:05 EST


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

> As agreed in the zh_TW scope discussion, include the notice added in the
> previous patch in every translation that nobody keeps in sync.
>
> The rule is per file rather than per directory: a translation carries
> the notice unless it is looked after. Today the looked-after set is
> process/, which the recent process series brought up to date, less the
> two files that have moved into process/ since and are already
> marked. Everything else is marked, index pages included: they carry
> translated prose and fall behind like any other page, and a notice on an
> area's index tells readers what to expect of the whole area. A file
> drops the notice once someone brings it up to date and takes it on.
>
> Left alone are index.rst, disclaimer-zh_TW.rst and glossary.rst, which
> do not translate an English document, and the notice itself.
>
> arch/index.rst and dev-tools/sparse.rst have no disclaimer include to
> sit next to -- the former never had one, the latter still uses the old
> plain-text header -- so the notice goes at the top of those two files.
> filesystems/sysfs.txt is not touched: Sphinx does not read .txt sources,
> so an include there would never be processed.

Well explained!

> Link: https://lore.kernel.org/linux-doc/CAKspUhJAbCWoxgh2eq8R5g_MiNK=oXgKPUWqGOpHh0w1-Fv74A@xxxxxxxxxxxxxx/
> Link: https://lore.kernel.org/linux-doc/aqFPBQxq5asHzvtn@xxxxxxxxx/
> Signed-off-by: Chen-Yu Yeh <chenyou910331@xxxxxxxxx>

Acked-by: Weijie Yuan <wy@xxxxxxxxx>
or
Reviewed-by: Weijie Yuan <wy@xxxxxxxxx>

Thanks.