mirror of https://lore.kernel.org/lkml/
 help / color / mirror / Atom feed
* [PATCH 0/3] docs/zh_TW: mark translations that are not kept in sync
@ 2026-09-29 13:11 Chen-Yu Yeh
  2026-09-29 13:11 ` [PATCH 1/3] docs/zh_TW: add a notice for translations " Chen-Yu Yeh
                   ` (2 more replies)
  0 siblings, 3 replies; 4+ messages in thread
From: Chen-Yu Yeh @ 2026-09-29 13:11 UTC (permalink / raw)
  To: corbet, alexs
  Cc: dzm91, wy, si.yanteng, srcres258, linux-doc, linux-kernel, Chen-Yu Yeh

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


^ permalink raw reply	[flat|nested] 4+ messages in thread
end of thread, other threads:[~2026-09-29 13:12 UTC | newest]

Thread overview: 4+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
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-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

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®