All of lore.kernel.org
 help / color / mirror / Atom feed
* [PATCH 0/7] docs/zh_TW: remove duplicated maintainer contact information
@ 2026-08-19 14:57 Chen-Yu Yeh
  2026-08-19 14:58 ` [PATCH 1/7] docs/zh_TW: process: remove " Chen-Yu Yeh
                   ` (6 more replies)
  0 siblings, 7 replies; 10+ messages in thread
From: Chen-Yu Yeh @ 2026-08-19 14:57 UTC (permalink / raw)
  To: Jonathan Corbet, Alex Shi
  Cc: Dongliang Mu, Weijie Yuan, Yanteng Si, Hu Haowen, linux-doc,
	linux-kernel, Chen-Yu Yeh

MAINTAINERS already records who to contact about the zh_TW
translations, yet every zh_TW file repeats that information in a
per-file contact block.  The duplication has a concrete cost: the
listed zh_TW maintainer address appears in 58 files and there have now
been three separate attempts to rewrite it across the tree.  In the
MAINTAINERS discussion Jon Corbet's conclusion was that, rather than
churning all of those addresses once more, the best thing is simply to
remove them.

There is a second reason.  The zh_TW tree was produced by converting
zh_CN, and the credit blocks came across with the text: nearly every
address removed here also appears in
Documentation/translations/zh_CN/, several in more than a hundred
files.  They credit the simplified-Chinese translation rather than
zh_TW work, so keeping them would leave the wrong attribution in place.

Removed:

  - the :Translator: / :翻譯: / :校譯: / :譯者: credit blocks and the
    譯者:: literal blocks
  - the "please contact the ... maintainer" prose that introduces them
  - the 英文版/中文版/繁體中文版 維護者|翻譯者|校譯者 lines, including
    their continuation lines
  - the maintainer metadata lines in the legacy headers (M:, zh_CN:,
    zh_TW:, Maintainer:, Chinese maintainer:, Traditional Chinese
    maintainer:)

Left alone: :Original:, :作者: (the author of the English original),
:日期:, :更新:, the C: sync-commit references, copyright notices, and
every address that is part of a document body, such as
stable@vger.kernel.org and the examples in submitting-patches.

Attribution for past work is preserved in the git history.

The last patch points disclaimer-zh_TW.rst and index.rst at
MAINTAINERS.  The disclaimer is included by every zh_TW document and
was the one place naming a specific person, so it matters most here;
disclaimer-zh_CN.rst already works this way.

Built with "make SPHINXDIRS=translations htmldocs": no new warnings,
no errors.

This series conflicts with the pending zh_TW process/ series [1], which
adds a translator entry to the same blocks in fifteen of these files.
Please apply that one first; I will respin this on top if it lands in a
different shape.

[1] https://lore.kernel.org/linux-doc/20260806181949.65648-1-chenyou910331@gmail.com/


Chen-Yu Yeh (7):
  docs/zh_TW: process: remove maintainer contact information
  docs/zh_TW: admin-guide: remove maintainer contact information
  docs/zh_TW: arch: remove maintainer contact information
  docs/zh_TW: dev-tools: remove maintainer contact information
  docs/zh_TW: filesystems: remove maintainer contact information
  docs/zh_TW: cpu-freq: remove maintainer contact information
  docs/zh_TW: remove the last maintainer contact references

 Documentation/translations/zh_TW/IRQ.txt        |  8 --------
 .../translations/zh_TW/admin-guide/README.rst   |  5 -----
 .../zh_TW/admin-guide/bootconfig.rst            |  2 --
 .../zh_TW/admin-guide/bug-bisect.rst            |  5 -----
 .../zh_TW/admin-guide/bug-hunting.rst           |  5 -----
 .../zh_TW/admin-guide/clearing-warn-once.rst    |  2 --
 .../translations/zh_TW/admin-guide/cpu-load.rst |  2 --
 .../zh_TW/admin-guide/cputopology.rst           |  4 ----
 .../translations/zh_TW/admin-guide/index.rst    |  2 --
 .../translations/zh_TW/admin-guide/init.rst     |  5 -----
 .../zh_TW/admin-guide/lockup-watchdogs.rst      |  1 -
 .../zh_TW/admin-guide/mm/damon/index.rst        |  6 ------
 .../zh_TW/admin-guide/mm/damon/lru_sort.rst     |  6 ------
 .../zh_TW/admin-guide/mm/damon/reclaim.rst      |  6 ------
 .../zh_TW/admin-guide/mm/damon/start.rst        |  6 ------
 .../zh_TW/admin-guide/mm/damon/usage.rst        |  6 ------
 .../translations/zh_TW/admin-guide/mm/index.rst |  5 -----
 .../translations/zh_TW/admin-guide/mm/ksm.rst   |  5 -----
 .../zh_TW/admin-guide/reporting-issues.rst      |  6 ------
 .../zh_TW/admin-guide/reporting-regressions.rst |  5 -----
 .../zh_TW/admin-guide/security-bugs.rst         |  5 -----
 .../translations/zh_TW/admin-guide/sysrq.rst    |  8 --------
 .../zh_TW/admin-guide/tainted-kernels.rst       |  5 -----
 .../translations/zh_TW/admin-guide/unicode.rst  |  5 -----
 .../translations/zh_TW/arch/arm/Booting         |  7 -------
 .../zh_TW/arch/arm/kernel_user_helpers.txt      | 10 ----------
 .../translations/zh_TW/arch/arm64/amu.rst       |  3 ---
 .../translations/zh_TW/arch/arm64/booting.txt   |  8 --------
 .../zh_TW/arch/arm64/elf_hwcaps.rst             |  3 ---
 .../zh_TW/arch/arm64/hugetlbpage.rst            |  3 ---
 .../translations/zh_TW/arch/arm64/index.rst     |  2 --
 .../zh_TW/arch/arm64/legacy_instructions.txt    | 11 -----------
 .../translations/zh_TW/arch/arm64/memory.txt    |  9 ---------
 .../translations/zh_TW/arch/arm64/perf.rst      |  3 ---
 .../zh_TW/arch/arm64/silicon-errata.txt         |  8 --------
 .../zh_TW/arch/arm64/tagged-pointers.txt        |  9 ---------
 .../zh_TW/arch/loongarch/booting.rst            |  4 ----
 .../zh_TW/arch/loongarch/features.rst           |  1 -
 .../translations/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    |  4 ----
 .../translations/zh_TW/arch/mips/features.rst   |  4 ----
 .../translations/zh_TW/arch/mips/index.rst      |  4 ----
 .../zh_TW/arch/mips/ingenic-tcu.rst             |  4 ----
 .../translations/zh_TW/arch/openrisc/index.rst  |  4 ----
 .../zh_TW/arch/openrisc/openrisc_port.rst       |  4 ----
 .../translations/zh_TW/arch/openrisc/todo.rst   |  4 ----
 .../zh_TW/arch/parisc/debugging.rst             |  4 ----
 .../translations/zh_TW/arch/parisc/index.rst    |  4 ----
 .../zh_TW/arch/parisc/registers.rst             |  4 ----
 .../translations/zh_TW/cpu-freq/core.rst        |  8 --------
 .../translations/zh_TW/cpu-freq/cpu-drivers.rst |  8 --------
 .../zh_TW/cpu-freq/cpufreq-stats.rst            |  8 --------
 .../translations/zh_TW/cpu-freq/index.rst       |  4 ----
 .../translations/zh_TW/dev-tools/gcov.rst       |  1 -
 .../zh_TW/dev-tools/gdb-kernel-debugging.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     |  5 -----
 .../zh_TW/dev-tools/testing-overview.rst        |  1 -
 .../translations/zh_TW/disclaimer-zh_TW.rst     |  7 ++++---
 .../translations/zh_TW/filesystems/debugfs.rst  | 10 ----------
 .../translations/zh_TW/filesystems/index.rst    |  2 --
 .../translations/zh_TW/filesystems/sysfs.txt    | 10 ----------
 .../translations/zh_TW/filesystems/virtiofs.rst |  8 --------
 Documentation/translations/zh_TW/index.rst      |  2 +-
 .../translations/zh_TW/io_ordering.txt          |  6 ------
 .../translations/zh_TW/process/1.Intro.rst      |  9 ---------
 .../translations/zh_TW/process/2.Process.rst    |  9 ---------
 .../zh_TW/process/3.Early-stage.rst             |  9 ---------
 .../translations/zh_TW/process/4.Coding.rst     |  9 ---------
 .../translations/zh_TW/process/5.Posting.rst    |  9 ---------
 .../zh_TW/process/6.Followthrough.rst           |  9 ---------
 .../zh_TW/process/7.AdvancedTopics.rst          |  9 ---------
 .../translations/zh_TW/process/8.Conclusion.rst |  8 --------
 .../process/code-of-conduct-interpretation.rst  |  2 --
 .../zh_TW/process/code-of-conduct.rst           |  2 --
 .../translations/zh_TW/process/coding-style.rst | 13 -------------
 .../zh_TW/process/development-process.rst       |  2 --
 .../zh_TW/process/email-clients.rst             | 11 -----------
 .../zh_TW/process/embargoed-hardware-issues.rst |  2 --
 .../translations/zh_TW/process/howto.rst        | 17 -----------------
 .../translations/zh_TW/process/index.rst        |  2 --
 .../zh_TW/process/kernel-driver-statement.rst   |  2 --
 .../process/kernel-enforcement-statement.rst    |  2 --
 .../zh_TW/process/license-rules.rst             |  2 --
 .../translations/zh_TW/process/magic-number.rst |  8 --------
 .../zh_TW/process/management-style.rst          |  2 --
 .../zh_TW/process/programming-language.rst      |  2 --
 .../zh_TW/process/stable-api-nonsense.rst       | 10 ----------
 .../zh_TW/process/stable-kernel-rules.rst       | 11 -----------
 .../zh_TW/process/submit-checklist.rst          |  4 ----
 .../zh_TW/process/submitting-patches.rst        | 11 -----------
 .../process/volatile-considered-harmful.rst     | 12 ------------
 95 files changed, 5 insertions(+), 505 deletions(-)

-- 
2.43.0


^ permalink raw reply	[flat|nested] 10+ messages in thread
end of thread, other threads:[~2026-08-19 17:38 UTC | newest]

Thread overview: 10+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2026-08-19 14:57 [PATCH 0/7] docs/zh_TW: remove duplicated maintainer contact information Chen-Yu Yeh
2026-08-19 14:58 ` [PATCH 1/7] docs/zh_TW: process: remove " Chen-Yu Yeh
2026-08-19 14:58 ` [PATCH 2/7] docs/zh_TW: admin-guide: " Chen-Yu Yeh
2026-08-19 14:58 ` [PATCH 3/7] docs/zh_TW: arch: " Chen-Yu Yeh
2026-08-19 14:58 ` [PATCH 4/7] docs/zh_TW: dev-tools: " Chen-Yu Yeh
2026-08-19 14:58 ` [PATCH 5/7] docs/zh_TW: filesystems: " Chen-Yu Yeh
2026-08-19 14:58 ` [PATCH 6/7] docs/zh_TW: cpu-freq: " Chen-Yu Yeh
2026-08-19 14:58 ` [PATCH 7/7] docs/zh_TW: remove the last maintainer contact references Chen-Yu Yeh
2026-08-19 17:17   ` Weijie Yuan
2026-08-19 17:38   ` Jonathan Corbet

This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.