[PATCH 0/7] docs/zh_TW: remove duplicated maintainer contact information

Chen-Yu Yeh posted 7 patches 1 month, 1 week ago
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(-)
[PATCH 0/7] docs/zh_TW: remove duplicated maintainer contact information
Posted by Chen-Yu Yeh 1 month, 1 week ago
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

Re: [PATCH 0/7] docs/zh_TW: remove duplicated maintainer contact information
Posted by Weijie Yuan 1 month, 1 week ago
> 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.

I hope we didn't get Jon's idea wrong.

> 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.

By the way, this is something that occurred to me as well: for articles
that were converted directly from Simplified Chinese, do we really have
grounds to say that the original authors should be responsible for the
Traditional Chinese versions? I tend to think not.

Of course, one could argue that some translation issues are not specific
to either Simplified or Traditional Chinese, but are issues with the
Chinese text more generally. Even so, I do not think the original
authors have a moral obligation to take responsibility for the converted
Traditional Chinese text. Perhaps it would have been better to say
something like, “The author of the Simplified Chinese original is xxx,”
but there is little point in discussing that now.

Putting those contributors in the "blame" line because of such converted
texts therefore seems somewhat unfair to me. So for articles converted
from Simplified Chinese, I agree with removing those statements.

> 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

Has anyone objected to multiple commits in this series sharing almost
the same commit message?  Just a thought.

> 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/

b4 automatically find a clean base for me: linus/master.

Thanks.

-- 
Weijie Yuan

Re: [PATCH 0/7] docs/zh_TW: remove duplicated maintainer contact information
Posted by 葉宸佑 1 month, 1 week ago
On Thu, Aug 20, 2026 at 12:43:39PM +0800, Weijie Yuan wrote:
> By the way, this is something that occurred to me as well: for articles
> that were converted directly from Simplified Chinese, do we really have
> grounds to say that the original authors should be responsible for the
> Traditional Chinese versions? I tend to think not.

That is the part I felt least comfortable about while preparing this,
so it is good to hear you reached the same conclusion independently.
Someone who wrote a zh_CN translation years ago did not sign up to
answer questions about a character-converted zh_TW copy of it.

> Has anyone objected to multiple commits in this series sharing almost
> the same commit message? Just a thought.

Fair point. The shared paragraph is there so each patch stands alone in
the log, but seven near-identical messages does read oddly. If this
needs a respin for any other reason I will differentiate them; I would
rather not resend seven patches for wording alone.


Chen-Yu