From: Chen-Yu Yeh <chenyou910331@gmail.com>
To: corbet@lwn.net, alexs@kernel.org
Cc: dzm91@hust.edu.cn, wy@wyuan.org, si.yanteng@linux.dev,
srcres258@furdevs.cn, linux-doc@vger.kernel.org,
linux-kernel@vger.kernel.org,
Chen-Yu Yeh <chenyou910331@gmail.com>
Subject: [PATCH 0/3] docs/zh_TW: mark translations that are not kept in sync
Date: Tue, 29 Sep 2026 21:11:37 +0800 [thread overview]
Message-ID: <20260929131142.266819-1-chenyou910331@gmail.com> (raw)
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.
This applies on top of the relocation series sent alongside it,
"[PATCH 0/4] docs/zh_TW: relocate translations to follow the English
layout".
[1] https://lore.kernel.org/linux-doc/CAKspUhJAbCWoxgh2eq8R5g_MiNK=oXgKPUWqGOpHh0w1-Fv74A@mail.gmail.com/
Chen-Yu Yeh (3):
docs/zh_TW: add a notice for translations not kept in sync
docs/zh_TW: mark translations outside the maintained set
docs/zh_TW: link filesystems/ and cpu-freq/ from the index
.../translations/zh_TW/admin-guide/README.rst | 1 +
.../zh_TW/admin-guide/bootconfig.rst | 1 +
.../zh_TW/admin-guide/bug-bisect.rst | 1 +
.../zh_TW/admin-guide/bug-hunting.rst | 1 +
.../zh_TW/admin-guide/clearing-warn-once.rst | 1 +
.../zh_TW/admin-guide/cpu-load.rst | 1 +
.../zh_TW/admin-guide/cputopology.rst | 1 +
.../translations/zh_TW/admin-guide/index.rst | 1 +
.../translations/zh_TW/admin-guide/init.rst | 1 +
.../zh_TW/admin-guide/lockup-watchdogs.rst | 1 +
.../zh_TW/admin-guide/mm/damon/index.rst | 1 +
.../zh_TW/admin-guide/mm/damon/lru_sort.rst | 1 +
.../zh_TW/admin-guide/mm/damon/reclaim.rst | 1 +
.../zh_TW/admin-guide/mm/damon/start.rst | 1 +
.../zh_TW/admin-guide/mm/damon/usage.rst | 1 +
.../zh_TW/admin-guide/mm/index.rst | 1 +
.../translations/zh_TW/admin-guide/mm/ksm.rst | 1 +
.../zh_TW/admin-guide/reporting-issues.rst | 1 +
.../admin-guide/reporting-regressions.rst | 1 +
.../translations/zh_TW/admin-guide/sysrq.rst | 1 +
.../zh_TW/admin-guide/tainted-kernels.rst | 1 +
.../zh_TW/admin-guide/unicode.rst | 1 +
.../translations/zh_TW/arch/arm64/amu.rst | 1 +
.../zh_TW/arch/arm64/elf_hwcaps.rst | 1 +
.../zh_TW/arch/arm64/hugetlbpage.rst | 1 +
.../translations/zh_TW/arch/arm64/index.rst | 1 +
.../translations/zh_TW/arch/arm64/perf.rst | 1 +
.../translations/zh_TW/arch/index.rst | 2 +
.../zh_TW/arch/loongarch/booting.rst | 1 +
.../zh_TW/arch/loongarch/features.rst | 1 +
.../zh_TW/arch/loongarch/index.rst | 1 +
.../zh_TW/arch/loongarch/introduction.rst | 1 +
.../zh_TW/arch/loongarch/irq-chip-model.rst | 1 +
.../translations/zh_TW/arch/mips/booting.rst | 1 +
.../translations/zh_TW/arch/mips/features.rst | 1 +
.../translations/zh_TW/arch/mips/index.rst | 1 +
.../zh_TW/arch/mips/ingenic-tcu.rst | 1 +
.../zh_TW/arch/openrisc/index.rst | 1 +
.../zh_TW/arch/openrisc/openrisc_port.rst | 1 +
.../translations/zh_TW/arch/openrisc/todo.rst | 1 +
.../zh_TW/arch/parisc/debugging.rst | 1 +
.../translations/zh_TW/arch/parisc/index.rst | 1 +
.../zh_TW/arch/parisc/registers.rst | 1 +
.../translations/zh_TW/cpu-freq/core.rst | 1 +
.../zh_TW/cpu-freq/cpu-drivers.rst | 1 +
.../zh_TW/cpu-freq/cpufreq-stats.rst | 1 +
.../translations/zh_TW/cpu-freq/index.rst | 1 +
.../translations/zh_TW/dev-tools/gcov.rst | 1 +
.../translations/zh_TW/dev-tools/index.rst | 1 +
.../translations/zh_TW/dev-tools/kasan.rst | 1 +
.../translations/zh_TW/dev-tools/sparse.rst | 4 +-
.../zh_TW/dev-tools/testing-overview.rst | 1 +
.../zh_TW/filesystems/debugfs.rst | 1 +
.../translations/zh_TW/filesystems/index.rst | 1 +
.../translations/zh_TW/filesystems/tmpfs.rst | 1 +
.../zh_TW/filesystems/virtiofs.rst | 1 +
Documentation/translations/zh_TW/index.rst | 6 +-
.../debugging/gdb-kernel-debugging.rst | 1 +
.../zh_TW/process/security-bugs.rst | 1 +
.../translations/zh_TW/staging/index.rst | 1 +
.../zh_TW/staging/magic-number.rst | 1 +
.../translations/zh_TW/subsystem-apis.rst | 99 +++++++++++++++++++
.../translations/zh_TW/unmaintained-zh_TW.rst | 6 ++
63 files changed, 173 insertions(+), 2 deletions(-)
create mode 100644 Documentation/translations/zh_TW/subsystem-apis.rst
create mode 100644 Documentation/translations/zh_TW/unmaintained-zh_TW.rst
--
2.43.0
next reply other threads:[~2026-09-29 13:11 UTC|newest]
Thread overview: 4+ messages / expand[flat|nested] mbox.gz Atom feed top
2026-09-29 13:11 Chen-Yu Yeh [this message]
2026-09-29 13:11 ` [PATCH 1/3] docs/zh_TW: add a notice for translations " Chen-Yu Yeh
2026-09-29 13:11 ` [PATCH 2/3] docs/zh_TW: mark translations outside the maintained set Chen-Yu Yeh
2026-09-29 13:11 ` [PATCH 3/3] docs/zh_TW: link filesystems/ and cpu-freq/ from the index Chen-Yu Yeh
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=20260929131142.266819-1-chenyou910331@gmail.com \
--to=chenyou910331@gmail.com \
--cc=alexs@kernel.org \
--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 \
--cc=wy@wyuan.org \
/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®