mirror of https://lore.kernel.org/lkml/
 help / color / mirror / Atom feed
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


  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®