From: Weijie Yuan <wy@wyuan.org>
To: Chen-Yu Yeh <chenyou910331@gmail.com>
Cc: corbet@lwn.net, alexs@kernel.org, dzm91@hust.edu.cn,
si.yanteng@linux.dev, srcres258@furdevs.cn,
linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org
Subject: Re: [PATCH 2/3] docs/zh_TW: mark translations outside the maintained set
Date: Sat, 3 Oct 2026 12:51:06 +0800 [thread overview]
Message-ID: <asCJurHmDhvDG_Gj@wyuan.org> (raw)
In-Reply-To: <20260929131142.266819-3-chenyou910331@gmail.com>
On 2026-09-29 21:11:39 +0800, Chen-Yu Yeh <chenyou910331@gmail.com> 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@mail.gmail.com/
> Link: https://lore.kernel.org/linux-doc/aqFPBQxq5asHzvtn@wyuan.org/
> Signed-off-by: Chen-Yu Yeh <chenyou910331@gmail.com>
Acked-by: Weijie Yuan <wy@wyuan.org>
or
Reviewed-by: Weijie Yuan <wy@wyuan.org>
Thanks.
next prev parent reply other threads:[~2026-10-03 4:51 UTC|newest]
Thread overview: 9+ messages / expand[flat|nested] mbox.gz Atom feed top
2026-09-29 13:11 [PATCH 0/3] docs/zh_TW: mark translations that are not kept in sync Chen-Yu Yeh
2026-09-29 13:11 ` [PATCH 1/3] docs/zh_TW: add a notice for translations " Chen-Yu Yeh
2026-10-03 4:45 ` Weijie Yuan
2026-10-03 10:23 ` 葉宸佑
2026-09-29 13:11 ` [PATCH 2/3] docs/zh_TW: mark translations outside the maintained set Chen-Yu Yeh
2026-10-03 4:51 ` Weijie Yuan [this message]
2026-09-29 13:11 ` [PATCH 3/3] docs/zh_TW: link filesystems/ and cpu-freq/ from the index Chen-Yu Yeh
2026-10-03 4:54 ` Weijie Yuan
2026-10-03 4:37 ` [PATCH 0/3] docs/zh_TW: mark translations that are not kept in sync Weijie Yuan
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=asCJurHmDhvDG_Gj@wyuan.org \
--to=wy@wyuan.org \
--cc=alexs@kernel.org \
--cc=chenyou910331@gmail.com \
--cc=corbet@lwn.net \
--cc=dzm91@hust.edu.cn \
--cc=linux-doc@vger.kernel.org \
--cc=linux-kernel@vger.kernel.org \
--cc=si.yanteng@linux.dev \
--cc=srcres258@furdevs.cn \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox
all inboxes | Powered by JetHome®