Re: [PATCH 1/3] docs/zh_TW: add a notice for translations not kept in sync

[Weijie Yuan]

On 2026-09-29 21:11:38 +0800, Chen-Yu Yeh <chenyou910331@xxxxxxxxx> wrote:

> 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@xxxxxxxxxxxxxx/
> Link: https://lore.kernel.org/linux-doc/aqFPBQxq5asHzvtn@xxxxxxxxx/
> Signed-off-by: Chen-Yu Yeh <chenyou910331@xxxxxxxxx>

Acked-by: Weijie Yuan <wy@xxxxxxxxx>

> ---
>  .../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欄位）為準。如果您願意協助更新本

So here means we still need the Original field.? ;)

> +     翻譯，歡迎將補丁提交給繁體中文文件的維護者（見MAINTAINERS檔案）。