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 1/3] docs/zh_TW: add a notice for translations not kept in sync
Date: Tue, 29 Sep 2026 21:11:38 +0800 [thread overview]
Message-ID: <20260929131142.266819-2-chenyou910331@gmail.com> (raw)
In-Reply-To: <20260929131142.266819-1-chenyou910331@gmail.com>
As agreed in the zh_TW scope discussion, translations that nobody keeps
in sync with their English originals should say so in the file itself,
rather than leave readers to find out. Add the notice as a shared file
included at the top of each such translation, the way
disclaimer-zh_TW.rst already is.
The notice carries no :orphan: marker. Included after
disclaimer-zh_TW.rst it would not be at the start of the document, and
Sphinx would render it as an empty "orphan" field; Sphinx does not warn
about a file that is only ever included, so the marker is not needed.
Start with the two files in process/ that are not in sync. process/ is
the part of zh_TW that is kept current, but security-bugs.rst and
debugging/gdb-kernel-debugging.rst only moved there with the recent
relocations and have not been updated yet; they carry the notice until
they are. The rest of the tree follows in the next patch.
Link: https://lore.kernel.org/linux-doc/CAKspUhJAbCWoxgh2eq8R5g_MiNK=oXgKPUWqGOpHh0w1-Fv74A@mail.gmail.com/
Link: https://lore.kernel.org/linux-doc/aqFPBQxq5asHzvtn@wyuan.org/
Signed-off-by: Chen-Yu Yeh <chenyou910331@gmail.com>
---
.../zh_TW/process/debugging/gdb-kernel-debugging.rst | 1 +
Documentation/translations/zh_TW/process/security-bugs.rst | 1 +
Documentation/translations/zh_TW/unmaintained-zh_TW.rst | 6 ++++++
3 files changed, 8 insertions(+)
create mode 100644 Documentation/translations/zh_TW/unmaintained-zh_TW.rst
diff --git a/Documentation/translations/zh_TW/process/debugging/gdb-kernel-debugging.rst b/Documentation/translations/zh_TW/process/debugging/gdb-kernel-debugging.rst
index a9ca1156fea6..45f178c0bf59 100644
--- a/Documentation/translations/zh_TW/process/debugging/gdb-kernel-debugging.rst
+++ b/Documentation/translations/zh_TW/process/debugging/gdb-kernel-debugging.rst
@@ -1,6 +1,7 @@
.. highlight:: none
.. include:: ../../disclaimer-zh_TW.rst
+.. include:: ../../unmaintained-zh_TW.rst
:Original: Documentation/process/debugging/gdb-kernel-debugging.rst
diff --git a/Documentation/translations/zh_TW/process/security-bugs.rst b/Documentation/translations/zh_TW/process/security-bugs.rst
index 76a78746ca4e..783d7c77b5fa 100644
--- a/Documentation/translations/zh_TW/process/security-bugs.rst
+++ b/Documentation/translations/zh_TW/process/security-bugs.rst
@@ -1,6 +1,7 @@
.. SPDX-License-Identifier: GPL-2.0
.. include:: ../disclaimer-zh_TW.rst
+.. include:: ../unmaintained-zh_TW.rst
:Original: :doc:`../../../process/security-bugs`
diff --git a/Documentation/translations/zh_TW/unmaintained-zh_TW.rst b/Documentation/translations/zh_TW/unmaintained-zh_TW.rst
new file mode 100644
index 000000000000..4b4eb63d749c
--- /dev/null
+++ b/Documentation/translations/zh_TW/unmaintained-zh_TW.rst
@@ -0,0 +1,6 @@
+.. SPDX-License-Identifier: GPL-2.0
+
+.. warning::
+ 本翻譯目前無人維護,沒有與英文原文保持同步,內容可能已經過時。如有
+ 出入,請以英文原文(見下方的Original欄位)為準。如果您願意協助更新本
+ 翻譯,歡迎將補丁提交給繁體中文文件的維護者(見MAINTAINERS檔案)。
--
2.43.0
next prev parent 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 [PATCH 0/3] docs/zh_TW: mark translations that are " Chen-Yu Yeh
2026-09-29 13:11 ` Chen-Yu Yeh [this message]
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-2-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®