Messages in this thread |  | | From | Chen-Yu Yeh <> | | Subject | [PATCH 0/3] docs/zh_TW: mark translations that are not kept in sync | | Date | Tue, 29 Sep 2026 21:11:37 +0800 |
| |
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
|  |