[PATCH v2] docs/zh_TW: drop unused enforcement statement label

From: Weijie Yuan

Date: Fri Oct 30 2026 - 01:53:11 EST


On Thu, Oct 29, 2026 at 08:13:21PM +0800, Weijie Yuan wrote:
> On Thu, Oct 29, 2026 at 07:50:43PM +0800, Dongliang Mu wrote:
> >
> > On 10/29/26 5:26 PM, Weijie Yuan wrote:
> > > I happened to notice that there was actually an embarrassing label on
> > > this page [*] that had been rendered in HTML.
> > >
> > > * https://docs.kernel.org/translations/zh_TW/process/kernel-enforcement-statement.html
> > >
> > > Therefore let me drop these labels in process dir but leave the cleanup
> > > job later.
> > >
> > > --- >8 ---
> > > From: Weijie Yuan <wy@xxxxxxxxx>
> > >
> > > We can link to these documents by path, so the top-level labels
> > > do not buy us anything.
> > >
> > > Drop these redundant labels from the Traditional Chinese process
> > > documents.
> >
> > Hi Weijie,
> >
> > Removing these labels breaks existing zh_TW cross-references. The patch
> > deletes 25 labels, but 17 of them are still targets of 25 :ref: uses.
> >
> > Dongliang Mu
>
> Thanks for your quick check! Indeed, there are many of them being used.
> I'm doing this stupidly, sorry.
>
> Then I'm wondering why 'make htmldocs' did not complain about this..
>
> [compiled again..] OK, that's because my machine stuck for a moment.
> Sphinx did complain about this, ouch.
>
> Anyway, the actual reason of this patch is here:
>
> > > diff --git a/Documentation/translations/zh_TW/process/kernel-enforcement-statement.rst b/Documentation/translations/zh_TW/process/kernel-enforcement-statement.rst
> > > index d54d20529294..45bb50fd1e6a 100644
> > > --- a/Documentation/translations/zh_TW/process/kernel-enforcement-statement.rst
> > > +++ b/Documentation/translations/zh_TW/process/kernel-enforcement-statement.rst
> > > @@ -1,7 +1,5 @@
> > > .. SPDX-License-Identifier: GPL-2.0
> > > -.. _tw_process_statement_kernel:
> > > -
> > > .. include:: ../disclaimer-zh_TW.rst
> > > :Original: :ref:`Documentation/process/kernel-enforcement-statement.rst <process_statement_kernel>`
>
> There is an invisible U+FEFF character before '.. _tw_process_statement_kernel:'
> prevents it from being recognized as a label, causing it to be rendered
> as plain text in the HTML output.
>
> Will handle these issues soon.

Hmm, now I realized that the last patch I submitted actually covered too
wide a scope. The English originals still use those labels and
references, e.g. ":ref:`development_process`" so I do not have a every
strong standpoint to change zh_TW which would make our translation
inconsistent with the original one.

Therefore, here comes v2 which is only aiming to remove that
embarrassing label.

-- >8 --
From: Weijie Yuan <wy@xxxxxxxxx>
Subject: [PATCH v2] docs/zh_TW: drop unused enforcement statement label

The tw_process_statement_kernel label has an invisible U+FEFF character
before its opening "..". This prevents the reStructuredText parser from
recognizing it, so the HTML output shows the label definition as plain
text.

Nothing in the tree refers to this label, and the table of contents uses
the document path. Drop the unused label to remove the stray text from
the output.

Signed-off-by: Weijie Yuan <wy@xxxxxxxxx>
---
.../translations/zh_TW/process/kernel-enforcement-statement.rst | 2 --
1 file changed, 2 deletions(-)

diff --git a/Documentation/translations/zh_TW/process/kernel-enforcement-statement.rst b/Documentation/translations/zh_TW/process/kernel-enforcement-statement.rst
index d54d20529294..45bb50fd1e6a 100644
--- a/Documentation/translations/zh_TW/process/kernel-enforcement-statement.rst
+++ b/Documentation/translations/zh_TW/process/kernel-enforcement-statement.rst
@@ -1,7 +1,5 @@
.. SPDX-License-Identifier: GPL-2.0

-.. _tw_process_statement_kernel:
-
.. include:: ../disclaimer-zh_TW.rst

:Original: :ref:`Documentation/process/kernel-enforcement-statement.rst <process_statement_kernel>`
--
2.56.0.385.gac671c819a