Re: [PATCH] docs/zh_TW: remove top-level labels from process/

[Weijie Yuan]

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.

Thanks!