mirror of https://lore.kernel.org/lkml/
 help / color / mirror / Atom feed
* [PATCH] docs/zh_TW: remove top-level labels from process/
@ 2026-10-29  9:26 Weijie Yuan
  2026-10-29 11:50 ` Dongliang Mu
  0 siblings, 1 reply; 3+ messages in thread
From: Weijie Yuan @ 2026-10-29  9:26 UTC (permalink / raw)
  To: Dongliang Mu, Jonathan Corbet, Shuah Khan, Randy Dunlap,
	Weijie Yuan, Chen-Yu Yeh
  Cc: linux-doc, linux-kernel

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@wyuan.org>

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.

Signed-off-by: Weijie Yuan <wy@wyuan.org>
---

 * Tested with '(make cleandocs && make htmldocs) 2>&1 | grep -F -e zh_CN -e zh_TW'
   seems work fine. But please leave an eye on this if available.

 * Based on these series on top of Alex's docs-next branch..
   - [v2 0/7] docs/zh_TW: remove duplicated maintainer contact information
   - [0/4] docs/zh_TW: relocate translations to follow the English layout
   - [1/1] docs/zh_TW: remove the unreachable plain-text translations
   - [0/3] docs/zh_TW: mark translations that are not kept in sync

   which are currently queued here for 7.5:
   https://github.com/kernel-zh/linux-zh_TW.git docs-next

 Documentation/translations/zh_TW/process/1.Intro.rst            | 2 --
 Documentation/translations/zh_TW/process/2.Process.rst          | 2 --
 Documentation/translations/zh_TW/process/3.Early-stage.rst      | 2 --
 Documentation/translations/zh_TW/process/4.Coding.rst           | 2 --
 Documentation/translations/zh_TW/process/5.Posting.rst          | 2 --
 Documentation/translations/zh_TW/process/6.Followthrough.rst    | 2 --
 Documentation/translations/zh_TW/process/7.AdvancedTopics.rst   | 2 --
 Documentation/translations/zh_TW/process/8.Conclusion.rst       | 2 --
 .../zh_TW/process/code-of-conduct-interpretation.rst            | 2 --
 Documentation/translations/zh_TW/process/code-of-conduct.rst    | 2 --
 Documentation/translations/zh_TW/process/coding-style.rst       | 2 --
 .../translations/zh_TW/process/development-process.rst          | 2 --
 Documentation/translations/zh_TW/process/email-clients.rst      | 2 --
 Documentation/translations/zh_TW/process/howto.rst              | 2 --
 Documentation/translations/zh_TW/process/index.rst              | 2 --
 .../translations/zh_TW/process/kernel-driver-statement.rst      | 2 --
 .../translations/zh_TW/process/kernel-enforcement-statement.rst | 2 --
 Documentation/translations/zh_TW/process/license-rules.rst      | 2 --
 Documentation/translations/zh_TW/process/management-style.rst   | 2 --
 .../translations/zh_TW/process/programming-language.rst         | 2 --
 .../translations/zh_TW/process/stable-api-nonsense.rst          | 2 --
 .../translations/zh_TW/process/stable-kernel-rules.rst          | 2 --
 Documentation/translations/zh_TW/process/submit-checklist.rst   | 2 --
 Documentation/translations/zh_TW/process/submitting-patches.rst | 2 --
 .../translations/zh_TW/process/volatile-considered-harmful.rst  | 2 --
 25 files changed, 50 deletions(-)

diff --git a/Documentation/translations/zh_TW/process/1.Intro.rst b/Documentation/translations/zh_TW/process/1.Intro.rst
index 65c5ae095504..0c1c6709b1cb 100644
--- a/Documentation/translations/zh_TW/process/1.Intro.rst
+++ b/Documentation/translations/zh_TW/process/1.Intro.rst
@@ -4,8 +4,6 @@
 
 :Original: :ref:`Documentation/process/1.Intro.rst <development_process_intro>`
 
-.. _tw_development_process_intro:
-
 引言
 ====
 
diff --git a/Documentation/translations/zh_TW/process/2.Process.rst b/Documentation/translations/zh_TW/process/2.Process.rst
index cf9bd1b1444a..85e1444b3be6 100644
--- a/Documentation/translations/zh_TW/process/2.Process.rst
+++ b/Documentation/translations/zh_TW/process/2.Process.rst
@@ -4,8 +4,6 @@
 
 :Original: :ref:`Documentation/process/2.Process.rst <development_process>`
 
-.. _tw_development_process:
-
 開發流程如何進行
 ================
 
diff --git a/Documentation/translations/zh_TW/process/3.Early-stage.rst b/Documentation/translations/zh_TW/process/3.Early-stage.rst
index 7d7ecf9658e5..be3dadcf1663 100644
--- a/Documentation/translations/zh_TW/process/3.Early-stage.rst
+++ b/Documentation/translations/zh_TW/process/3.Early-stage.rst
@@ -4,8 +4,6 @@
 
 :Original: :ref:`Documentation/process/3.Early-stage.rst <development_early_stage>`
 
-.. _tw_development_early_stage:
-
 早期規劃
 ========
 
diff --git a/Documentation/translations/zh_TW/process/4.Coding.rst b/Documentation/translations/zh_TW/process/4.Coding.rst
index 423d51f4b3de..982735fd6134 100644
--- a/Documentation/translations/zh_TW/process/4.Coding.rst
+++ b/Documentation/translations/zh_TW/process/4.Coding.rst
@@ -4,8 +4,6 @@
 
 :Original: :ref:`Documentation/process/4.Coding.rst <development_coding>`
 
-.. _tw_development_coding:
-
 使代碼正確
 ======================
 
diff --git a/Documentation/translations/zh_TW/process/5.Posting.rst b/Documentation/translations/zh_TW/process/5.Posting.rst
index d54b16364474..ba3b8a79f21a 100644
--- a/Documentation/translations/zh_TW/process/5.Posting.rst
+++ b/Documentation/translations/zh_TW/process/5.Posting.rst
@@ -4,8 +4,6 @@
 
 :Original: :ref:`Documentation/process/5.Posting.rst <development_posting>`
 
-.. _tw_development_posting:
-
 發布補丁
 ========
 
diff --git a/Documentation/translations/zh_TW/process/6.Followthrough.rst b/Documentation/translations/zh_TW/process/6.Followthrough.rst
index 76082a15677f..e9a70eec850c 100644
--- a/Documentation/translations/zh_TW/process/6.Followthrough.rst
+++ b/Documentation/translations/zh_TW/process/6.Followthrough.rst
@@ -4,8 +4,6 @@
 
 :Original: :ref:`Documentation/process/6.Followthrough.rst <development_followthrough>`
 
-.. _tw_development_followthrough:
-
 跟進
 ====
 
diff --git a/Documentation/translations/zh_TW/process/7.AdvancedTopics.rst b/Documentation/translations/zh_TW/process/7.AdvancedTopics.rst
index 392c00213078..fb2e3764802f 100644
--- a/Documentation/translations/zh_TW/process/7.AdvancedTopics.rst
+++ b/Documentation/translations/zh_TW/process/7.AdvancedTopics.rst
@@ -4,8 +4,6 @@
 
 :Original: :ref:`Documentation/process/7.AdvancedTopics.rst <development_advancedtopics>`
 
-.. _tw_development_advancedtopics:
-
 進階主題
 ========
 
diff --git a/Documentation/translations/zh_TW/process/8.Conclusion.rst b/Documentation/translations/zh_TW/process/8.Conclusion.rst
index 2436263c6506..82e89d992964 100644
--- a/Documentation/translations/zh_TW/process/8.Conclusion.rst
+++ b/Documentation/translations/zh_TW/process/8.Conclusion.rst
@@ -4,8 +4,6 @@
 
 :Original: :ref:`Documentation/process/8.Conclusion.rst <development_conclusion>`
 
-.. _tw_development_conclusion:
-
 更多資訊
 ========
 
diff --git a/Documentation/translations/zh_TW/process/code-of-conduct-interpretation.rst b/Documentation/translations/zh_TW/process/code-of-conduct-interpretation.rst
index 4fc568409198..fbb9fb719b19 100644
--- a/Documentation/translations/zh_TW/process/code-of-conduct-interpretation.rst
+++ b/Documentation/translations/zh_TW/process/code-of-conduct-interpretation.rst
@@ -4,8 +4,6 @@
 
 :Original: :ref:`Documentation/process/code-of-conduct-interpretation.rst <code_of_conduct_interpretation>`
 
-.. _tw_code_of_conduct_interpretation:
-
 Linux核心貢獻者契約行為準則解釋
 ===============================
 
diff --git a/Documentation/translations/zh_TW/process/code-of-conduct.rst b/Documentation/translations/zh_TW/process/code-of-conduct.rst
index 0266cd74a0b1..4db8ddc71474 100644
--- a/Documentation/translations/zh_TW/process/code-of-conduct.rst
+++ b/Documentation/translations/zh_TW/process/code-of-conduct.rst
@@ -4,8 +4,6 @@
 
 :Original: :ref:`Documentation/process/code-of-conduct.rst <code_of_conduct>`
 
-.. _tw_code_of_conduct:
-
 貢獻者契約行爲準則
 ++++++++++++++++++
 
diff --git a/Documentation/translations/zh_TW/process/coding-style.rst b/Documentation/translations/zh_TW/process/coding-style.rst
index 5778b707503f..166b952cb54e 100644
--- a/Documentation/translations/zh_TW/process/coding-style.rst
+++ b/Documentation/translations/zh_TW/process/coding-style.rst
@@ -4,8 +4,6 @@
 
 :Original: Documentation/process/coding-style.rst
 
-.. _tw_codingstyle:
-
 Linux 核心程式碼風格
 ====================
 
diff --git a/Documentation/translations/zh_TW/process/development-process.rst b/Documentation/translations/zh_TW/process/development-process.rst
index 1d22aa0d3711..e3e69882d8f6 100644
--- a/Documentation/translations/zh_TW/process/development-process.rst
+++ b/Documentation/translations/zh_TW/process/development-process.rst
@@ -4,8 +4,6 @@
 
 :Original: :ref:`Documentation/process/development-process.rst <development_process_main>`
 
-.. _tw_development_process_main:
-
 內核開發過程指南
 ================
 
diff --git a/Documentation/translations/zh_TW/process/email-clients.rst b/Documentation/translations/zh_TW/process/email-clients.rst
index 272e3073521d..7a5cf79fe4f9 100644
--- a/Documentation/translations/zh_TW/process/email-clients.rst
+++ b/Documentation/translations/zh_TW/process/email-clients.rst
@@ -2,8 +2,6 @@
 
 .. include:: ../disclaimer-zh_TW.rst
 
-.. _tw_email_clients:
-
 :Original: Documentation/process/email-clients.rst
 
 Linux郵件客戶端設定資訊
diff --git a/Documentation/translations/zh_TW/process/howto.rst b/Documentation/translations/zh_TW/process/howto.rst
index 1ffc076ce26c..46c7a63398f7 100644
--- a/Documentation/translations/zh_TW/process/howto.rst
+++ b/Documentation/translations/zh_TW/process/howto.rst
@@ -1,7 +1,5 @@
 .. SPDX-License-Identifier: GPL-2.0
 
-.. _tw_process_howto:
-
 .. include:: ../disclaimer-zh_TW.rst
 
 :Original: :ref:`Documentation/process/howto.rst <process_howto>`
diff --git a/Documentation/translations/zh_TW/process/index.rst b/Documentation/translations/zh_TW/process/index.rst
index bd638264bbe4..b27af36ce3bb 100644
--- a/Documentation/translations/zh_TW/process/index.rst
+++ b/Documentation/translations/zh_TW/process/index.rst
@@ -9,8 +9,6 @@
 
 :Original: :ref:`Documentation/process/index.rst <process_index>`
 
-.. _tw_process_index:
-
 ========================
 與Linux核心社群一起工作
 ========================
diff --git a/Documentation/translations/zh_TW/process/kernel-driver-statement.rst b/Documentation/translations/zh_TW/process/kernel-driver-statement.rst
index 34bcb6f164cb..e6ff67f75650 100644
--- a/Documentation/translations/zh_TW/process/kernel-driver-statement.rst
+++ b/Documentation/translations/zh_TW/process/kernel-driver-statement.rst
@@ -1,7 +1,5 @@
 .. SPDX-License-Identifier: GPL-2.0
 
-.. _tw_process_statement_driver:
-
 .. include:: ../disclaimer-zh_TW.rst
 
 :Original: :ref:`Documentation/process/kernel-driver-statement.rst <process_statement_driver>`
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>`
diff --git a/Documentation/translations/zh_TW/process/license-rules.rst b/Documentation/translations/zh_TW/process/license-rules.rst
index 0a4558b7fc76..8f9b57e223a7 100644
--- a/Documentation/translations/zh_TW/process/license-rules.rst
+++ b/Documentation/translations/zh_TW/process/license-rules.rst
@@ -4,8 +4,6 @@
 
 :Original: :ref:`Documentation/process/license-rules.rst <kernel_licensing>`
 
-.. _tw_kernel_licensing:
-
 Linux核心許可規則
 =================
 
diff --git a/Documentation/translations/zh_TW/process/management-style.rst b/Documentation/translations/zh_TW/process/management-style.rst
index 2cef0ef25ede..9908724e37a2 100644
--- a/Documentation/translations/zh_TW/process/management-style.rst
+++ b/Documentation/translations/zh_TW/process/management-style.rst
@@ -4,8 +4,6 @@
 
 :Original: :ref:`Documentation/process/management-style.rst <managementstyle>`
 
-.. _tw_managementstyle:
-
 Linux內核管理風格
 =================
 
diff --git a/Documentation/translations/zh_TW/process/programming-language.rst b/Documentation/translations/zh_TW/process/programming-language.rst
index 9aac89e2c23b..04ad22a25a4e 100644
--- a/Documentation/translations/zh_TW/process/programming-language.rst
+++ b/Documentation/translations/zh_TW/process/programming-language.rst
@@ -4,8 +4,6 @@
 
 :Original: :ref:`Documentation/process/programming-language.rst <programming_language>`
 
-.. _tw_programming_language:
-
 程式語言
 ========
 
diff --git a/Documentation/translations/zh_TW/process/stable-api-nonsense.rst b/Documentation/translations/zh_TW/process/stable-api-nonsense.rst
index 94748429c182..2e82df8544ef 100644
--- a/Documentation/translations/zh_TW/process/stable-api-nonsense.rst
+++ b/Documentation/translations/zh_TW/process/stable-api-nonsense.rst
@@ -1,7 +1,5 @@
 .. SPDX-License-Identifier: GPL-2.0
 
-.. _tw_stable_api_nonsense:
-
 .. include:: ../disclaimer-zh_TW.rst
 
 :Original: :ref:`Documentation/process/stable-api-nonsense.rst
diff --git a/Documentation/translations/zh_TW/process/stable-kernel-rules.rst b/Documentation/translations/zh_TW/process/stable-kernel-rules.rst
index d182d625728d..bd0a1599dbff 100644
--- a/Documentation/translations/zh_TW/process/stable-kernel-rules.rst
+++ b/Documentation/translations/zh_TW/process/stable-kernel-rules.rst
@@ -1,7 +1,5 @@
 .. SPDX-License-Identifier: GPL-2.0
 
-.. _tw_stable_kernel_rules:
-
 .. include:: ../disclaimer-zh_TW.rst
 
 :Original: :ref:`Documentation/process/stable-kernel-rules.rst <stable_kernel_rules>`
diff --git a/Documentation/translations/zh_TW/process/submit-checklist.rst b/Documentation/translations/zh_TW/process/submit-checklist.rst
index 452fecc7c425..f5b2cb56eec4 100644
--- a/Documentation/translations/zh_TW/process/submit-checklist.rst
+++ b/Documentation/translations/zh_TW/process/submit-checklist.rst
@@ -4,8 +4,6 @@
 
 :Original: Documentation/process/submit-checklist.rst
 
-.. _tw_submitchecklist:
-
 Linux內核補丁提交檢查單
 ~~~~~~~~~~~~~~~~~~~~~~~
 
diff --git a/Documentation/translations/zh_TW/process/submitting-patches.rst b/Documentation/translations/zh_TW/process/submitting-patches.rst
index 514903daae25..967e558350c0 100644
--- a/Documentation/translations/zh_TW/process/submitting-patches.rst
+++ b/Documentation/translations/zh_TW/process/submitting-patches.rst
@@ -2,8 +2,6 @@
 
 .. include:: ../disclaimer-zh_TW.rst
 
-.. _tw_submittingpatches:
-
 :Original: Documentation/process/submitting-patches.rst
 
 提交補丁:如何讓你的改動進入核心
diff --git a/Documentation/translations/zh_TW/process/volatile-considered-harmful.rst b/Documentation/translations/zh_TW/process/volatile-considered-harmful.rst
index edfc83f32672..a2384b60b874 100644
--- a/Documentation/translations/zh_TW/process/volatile-considered-harmful.rst
+++ b/Documentation/translations/zh_TW/process/volatile-considered-harmful.rst
@@ -1,7 +1,5 @@
 .. SPDX-License-Identifier: GPL-2.0
 
-.. _tw_volatile_considered_harmful:
-
 .. include:: ../disclaimer-zh_TW.rst
 
 :Original: :ref:`Documentation/process/volatile-considered-harmful.rst
-- 

^ permalink raw reply	[flat|nested] 3+ messages in thread

* Re: [PATCH] docs/zh_TW: remove top-level labels from process/
  2026-10-29  9:26 [PATCH] docs/zh_TW: remove top-level labels from process/ Weijie Yuan
@ 2026-10-29 11:50 ` Dongliang Mu
  2026-10-29 12:13   ` Weijie Yuan
  0 siblings, 1 reply; 3+ messages in thread
From: Dongliang Mu @ 2026-10-29 11:50 UTC (permalink / raw)
  To: Weijie Yuan, Jonathan Corbet, Shuah Khan, Randy Dunlap,
	Weijie Yuan, Chen-Yu Yeh
  Cc: linux-doc, linux-kernel


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@wyuan.org>
>
> 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

>
> Signed-off-by: Weijie Yuan <wy@wyuan.org>
> ---
>
>   * Tested with '(make cleandocs && make htmldocs) 2>&1 | grep -F -e zh_CN -e zh_TW'
>     seems work fine. But please leave an eye on this if available.
>
>   * Based on these series on top of Alex's docs-next branch..
>     - [v2 0/7] docs/zh_TW: remove duplicated maintainer contact information
>     - [0/4] docs/zh_TW: relocate translations to follow the English layout
>     - [1/1] docs/zh_TW: remove the unreachable plain-text translations
>     - [0/3] docs/zh_TW: mark translations that are not kept in sync
>
>     which are currently queued here for 7.5:
>     https://github.com/kernel-zh/linux-zh_TW.git docs-next
>
>   Documentation/translations/zh_TW/process/1.Intro.rst            | 2 --
>   Documentation/translations/zh_TW/process/2.Process.rst          | 2 --
>   Documentation/translations/zh_TW/process/3.Early-stage.rst      | 2 --
>   Documentation/translations/zh_TW/process/4.Coding.rst           | 2 --
>   Documentation/translations/zh_TW/process/5.Posting.rst          | 2 --
>   Documentation/translations/zh_TW/process/6.Followthrough.rst    | 2 --
>   Documentation/translations/zh_TW/process/7.AdvancedTopics.rst   | 2 --
>   Documentation/translations/zh_TW/process/8.Conclusion.rst       | 2 --
>   .../zh_TW/process/code-of-conduct-interpretation.rst            | 2 --
>   Documentation/translations/zh_TW/process/code-of-conduct.rst    | 2 --
>   Documentation/translations/zh_TW/process/coding-style.rst       | 2 --
>   .../translations/zh_TW/process/development-process.rst          | 2 --
>   Documentation/translations/zh_TW/process/email-clients.rst      | 2 --
>   Documentation/translations/zh_TW/process/howto.rst              | 2 --
>   Documentation/translations/zh_TW/process/index.rst              | 2 --
>   .../translations/zh_TW/process/kernel-driver-statement.rst      | 2 --
>   .../translations/zh_TW/process/kernel-enforcement-statement.rst | 2 --
>   Documentation/translations/zh_TW/process/license-rules.rst      | 2 --
>   Documentation/translations/zh_TW/process/management-style.rst   | 2 --
>   .../translations/zh_TW/process/programming-language.rst         | 2 --
>   .../translations/zh_TW/process/stable-api-nonsense.rst          | 2 --
>   .../translations/zh_TW/process/stable-kernel-rules.rst          | 2 --
>   Documentation/translations/zh_TW/process/submit-checklist.rst   | 2 --
>   Documentation/translations/zh_TW/process/submitting-patches.rst | 2 --
>   .../translations/zh_TW/process/volatile-considered-harmful.rst  | 2 --
>   25 files changed, 50 deletions(-)
>
> diff --git a/Documentation/translations/zh_TW/process/1.Intro.rst b/Documentation/translations/zh_TW/process/1.Intro.rst
> index 65c5ae095504..0c1c6709b1cb 100644
> --- a/Documentation/translations/zh_TW/process/1.Intro.rst
> +++ b/Documentation/translations/zh_TW/process/1.Intro.rst
> @@ -4,8 +4,6 @@
>   
>   :Original: :ref:`Documentation/process/1.Intro.rst <development_process_intro>`
>   
> -.. _tw_development_process_intro:
> -
>   引言
>   ====
>   
> diff --git a/Documentation/translations/zh_TW/process/2.Process.rst b/Documentation/translations/zh_TW/process/2.Process.rst
> index cf9bd1b1444a..85e1444b3be6 100644
> --- a/Documentation/translations/zh_TW/process/2.Process.rst
> +++ b/Documentation/translations/zh_TW/process/2.Process.rst
> @@ -4,8 +4,6 @@
>   
>   :Original: :ref:`Documentation/process/2.Process.rst <development_process>`
>   
> -.. _tw_development_process:
> -
>   開發流程如何進行
>   ================
>   
> diff --git a/Documentation/translations/zh_TW/process/3.Early-stage.rst b/Documentation/translations/zh_TW/process/3.Early-stage.rst
> index 7d7ecf9658e5..be3dadcf1663 100644
> --- a/Documentation/translations/zh_TW/process/3.Early-stage.rst
> +++ b/Documentation/translations/zh_TW/process/3.Early-stage.rst
> @@ -4,8 +4,6 @@
>   
>   :Original: :ref:`Documentation/process/3.Early-stage.rst <development_early_stage>`
>   
> -.. _tw_development_early_stage:
> -
>   早期規劃
>   ========
>   
> diff --git a/Documentation/translations/zh_TW/process/4.Coding.rst b/Documentation/translations/zh_TW/process/4.Coding.rst
> index 423d51f4b3de..982735fd6134 100644
> --- a/Documentation/translations/zh_TW/process/4.Coding.rst
> +++ b/Documentation/translations/zh_TW/process/4.Coding.rst
> @@ -4,8 +4,6 @@
>   
>   :Original: :ref:`Documentation/process/4.Coding.rst <development_coding>`
>   
> -.. _tw_development_coding:
> -
>   使代碼正確
>   ======================
>   
> diff --git a/Documentation/translations/zh_TW/process/5.Posting.rst b/Documentation/translations/zh_TW/process/5.Posting.rst
> index d54b16364474..ba3b8a79f21a 100644
> --- a/Documentation/translations/zh_TW/process/5.Posting.rst
> +++ b/Documentation/translations/zh_TW/process/5.Posting.rst
> @@ -4,8 +4,6 @@
>   
>   :Original: :ref:`Documentation/process/5.Posting.rst <development_posting>`
>   
> -.. _tw_development_posting:
> -
>   發布補丁
>   ========
>   
> diff --git a/Documentation/translations/zh_TW/process/6.Followthrough.rst b/Documentation/translations/zh_TW/process/6.Followthrough.rst
> index 76082a15677f..e9a70eec850c 100644
> --- a/Documentation/translations/zh_TW/process/6.Followthrough.rst
> +++ b/Documentation/translations/zh_TW/process/6.Followthrough.rst
> @@ -4,8 +4,6 @@
>   
>   :Original: :ref:`Documentation/process/6.Followthrough.rst <development_followthrough>`
>   
> -.. _tw_development_followthrough:
> -
>   跟進
>   ====
>   
> diff --git a/Documentation/translations/zh_TW/process/7.AdvancedTopics.rst b/Documentation/translations/zh_TW/process/7.AdvancedTopics.rst
> index 392c00213078..fb2e3764802f 100644
> --- a/Documentation/translations/zh_TW/process/7.AdvancedTopics.rst
> +++ b/Documentation/translations/zh_TW/process/7.AdvancedTopics.rst
> @@ -4,8 +4,6 @@
>   
>   :Original: :ref:`Documentation/process/7.AdvancedTopics.rst <development_advancedtopics>`
>   
> -.. _tw_development_advancedtopics:
> -
>   進階主題
>   ========
>   
> diff --git a/Documentation/translations/zh_TW/process/8.Conclusion.rst b/Documentation/translations/zh_TW/process/8.Conclusion.rst
> index 2436263c6506..82e89d992964 100644
> --- a/Documentation/translations/zh_TW/process/8.Conclusion.rst
> +++ b/Documentation/translations/zh_TW/process/8.Conclusion.rst
> @@ -4,8 +4,6 @@
>   
>   :Original: :ref:`Documentation/process/8.Conclusion.rst <development_conclusion>`
>   
> -.. _tw_development_conclusion:
> -
>   更多資訊
>   ========
>   
> diff --git a/Documentation/translations/zh_TW/process/code-of-conduct-interpretation.rst b/Documentation/translations/zh_TW/process/code-of-conduct-interpretation.rst
> index 4fc568409198..fbb9fb719b19 100644
> --- a/Documentation/translations/zh_TW/process/code-of-conduct-interpretation.rst
> +++ b/Documentation/translations/zh_TW/process/code-of-conduct-interpretation.rst
> @@ -4,8 +4,6 @@
>   
>   :Original: :ref:`Documentation/process/code-of-conduct-interpretation.rst <code_of_conduct_interpretation>`
>   
> -.. _tw_code_of_conduct_interpretation:
> -
>   Linux核心貢獻者契約行為準則解釋
>   ===============================
>   
> diff --git a/Documentation/translations/zh_TW/process/code-of-conduct.rst b/Documentation/translations/zh_TW/process/code-of-conduct.rst
> index 0266cd74a0b1..4db8ddc71474 100644
> --- a/Documentation/translations/zh_TW/process/code-of-conduct.rst
> +++ b/Documentation/translations/zh_TW/process/code-of-conduct.rst
> @@ -4,8 +4,6 @@
>   
>   :Original: :ref:`Documentation/process/code-of-conduct.rst <code_of_conduct>`
>   
> -.. _tw_code_of_conduct:
> -
>   貢獻者契約行爲準則
>   ++++++++++++++++++
>   
> diff --git a/Documentation/translations/zh_TW/process/coding-style.rst b/Documentation/translations/zh_TW/process/coding-style.rst
> index 5778b707503f..166b952cb54e 100644
> --- a/Documentation/translations/zh_TW/process/coding-style.rst
> +++ b/Documentation/translations/zh_TW/process/coding-style.rst
> @@ -4,8 +4,6 @@
>   
>   :Original: Documentation/process/coding-style.rst
>   
> -.. _tw_codingstyle:
> -
>   Linux 核心程式碼風格
>   ====================
>   
> diff --git a/Documentation/translations/zh_TW/process/development-process.rst b/Documentation/translations/zh_TW/process/development-process.rst
> index 1d22aa0d3711..e3e69882d8f6 100644
> --- a/Documentation/translations/zh_TW/process/development-process.rst
> +++ b/Documentation/translations/zh_TW/process/development-process.rst
> @@ -4,8 +4,6 @@
>   
>   :Original: :ref:`Documentation/process/development-process.rst <development_process_main>`
>   
> -.. _tw_development_process_main:
> -
>   內核開發過程指南
>   ================
>   
> diff --git a/Documentation/translations/zh_TW/process/email-clients.rst b/Documentation/translations/zh_TW/process/email-clients.rst
> index 272e3073521d..7a5cf79fe4f9 100644
> --- a/Documentation/translations/zh_TW/process/email-clients.rst
> +++ b/Documentation/translations/zh_TW/process/email-clients.rst
> @@ -2,8 +2,6 @@
>   
>   .. include:: ../disclaimer-zh_TW.rst
>   
> -.. _tw_email_clients:
> -
>   :Original: Documentation/process/email-clients.rst
>   
>   Linux郵件客戶端設定資訊
> diff --git a/Documentation/translations/zh_TW/process/howto.rst b/Documentation/translations/zh_TW/process/howto.rst
> index 1ffc076ce26c..46c7a63398f7 100644
> --- a/Documentation/translations/zh_TW/process/howto.rst
> +++ b/Documentation/translations/zh_TW/process/howto.rst
> @@ -1,7 +1,5 @@
>   .. SPDX-License-Identifier: GPL-2.0
>   
> -.. _tw_process_howto:
> -
>   .. include:: ../disclaimer-zh_TW.rst
>   
>   :Original: :ref:`Documentation/process/howto.rst <process_howto>`
> diff --git a/Documentation/translations/zh_TW/process/index.rst b/Documentation/translations/zh_TW/process/index.rst
> index bd638264bbe4..b27af36ce3bb 100644
> --- a/Documentation/translations/zh_TW/process/index.rst
> +++ b/Documentation/translations/zh_TW/process/index.rst
> @@ -9,8 +9,6 @@
>   
>   :Original: :ref:`Documentation/process/index.rst <process_index>`
>   
> -.. _tw_process_index:
> -
>   ========================
>   與Linux核心社群一起工作
>   ========================
> diff --git a/Documentation/translations/zh_TW/process/kernel-driver-statement.rst b/Documentation/translations/zh_TW/process/kernel-driver-statement.rst
> index 34bcb6f164cb..e6ff67f75650 100644
> --- a/Documentation/translations/zh_TW/process/kernel-driver-statement.rst
> +++ b/Documentation/translations/zh_TW/process/kernel-driver-statement.rst
> @@ -1,7 +1,5 @@
>   .. SPDX-License-Identifier: GPL-2.0
>   
> -.. _tw_process_statement_driver:
> -
>   .. include:: ../disclaimer-zh_TW.rst
>   
>   :Original: :ref:`Documentation/process/kernel-driver-statement.rst <process_statement_driver>`
> 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>`
> diff --git a/Documentation/translations/zh_TW/process/license-rules.rst b/Documentation/translations/zh_TW/process/license-rules.rst
> index 0a4558b7fc76..8f9b57e223a7 100644
> --- a/Documentation/translations/zh_TW/process/license-rules.rst
> +++ b/Documentation/translations/zh_TW/process/license-rules.rst
> @@ -4,8 +4,6 @@
>   
>   :Original: :ref:`Documentation/process/license-rules.rst <kernel_licensing>`
>   
> -.. _tw_kernel_licensing:
> -
>   Linux核心許可規則
>   =================
>   
> diff --git a/Documentation/translations/zh_TW/process/management-style.rst b/Documentation/translations/zh_TW/process/management-style.rst
> index 2cef0ef25ede..9908724e37a2 100644
> --- a/Documentation/translations/zh_TW/process/management-style.rst
> +++ b/Documentation/translations/zh_TW/process/management-style.rst
> @@ -4,8 +4,6 @@
>   
>   :Original: :ref:`Documentation/process/management-style.rst <managementstyle>`
>   
> -.. _tw_managementstyle:
> -
>   Linux內核管理風格
>   =================
>   
> diff --git a/Documentation/translations/zh_TW/process/programming-language.rst b/Documentation/translations/zh_TW/process/programming-language.rst
> index 9aac89e2c23b..04ad22a25a4e 100644
> --- a/Documentation/translations/zh_TW/process/programming-language.rst
> +++ b/Documentation/translations/zh_TW/process/programming-language.rst
> @@ -4,8 +4,6 @@
>   
>   :Original: :ref:`Documentation/process/programming-language.rst <programming_language>`
>   
> -.. _tw_programming_language:
> -
>   程式語言
>   ========
>   
> diff --git a/Documentation/translations/zh_TW/process/stable-api-nonsense.rst b/Documentation/translations/zh_TW/process/stable-api-nonsense.rst
> index 94748429c182..2e82df8544ef 100644
> --- a/Documentation/translations/zh_TW/process/stable-api-nonsense.rst
> +++ b/Documentation/translations/zh_TW/process/stable-api-nonsense.rst
> @@ -1,7 +1,5 @@
>   .. SPDX-License-Identifier: GPL-2.0
>   
> -.. _tw_stable_api_nonsense:
> -
>   .. include:: ../disclaimer-zh_TW.rst
>   
>   :Original: :ref:`Documentation/process/stable-api-nonsense.rst
> diff --git a/Documentation/translations/zh_TW/process/stable-kernel-rules.rst b/Documentation/translations/zh_TW/process/stable-kernel-rules.rst
> index d182d625728d..bd0a1599dbff 100644
> --- a/Documentation/translations/zh_TW/process/stable-kernel-rules.rst
> +++ b/Documentation/translations/zh_TW/process/stable-kernel-rules.rst
> @@ -1,7 +1,5 @@
>   .. SPDX-License-Identifier: GPL-2.0
>   
> -.. _tw_stable_kernel_rules:
> -
>   .. include:: ../disclaimer-zh_TW.rst
>   
>   :Original: :ref:`Documentation/process/stable-kernel-rules.rst <stable_kernel_rules>`
> diff --git a/Documentation/translations/zh_TW/process/submit-checklist.rst b/Documentation/translations/zh_TW/process/submit-checklist.rst
> index 452fecc7c425..f5b2cb56eec4 100644
> --- a/Documentation/translations/zh_TW/process/submit-checklist.rst
> +++ b/Documentation/translations/zh_TW/process/submit-checklist.rst
> @@ -4,8 +4,6 @@
>   
>   :Original: Documentation/process/submit-checklist.rst
>   
> -.. _tw_submitchecklist:
> -
>   Linux內核補丁提交檢查單
>   ~~~~~~~~~~~~~~~~~~~~~~~
>   
> diff --git a/Documentation/translations/zh_TW/process/submitting-patches.rst b/Documentation/translations/zh_TW/process/submitting-patches.rst
> index 514903daae25..967e558350c0 100644
> --- a/Documentation/translations/zh_TW/process/submitting-patches.rst
> +++ b/Documentation/translations/zh_TW/process/submitting-patches.rst
> @@ -2,8 +2,6 @@
>   
>   .. include:: ../disclaimer-zh_TW.rst
>   
> -.. _tw_submittingpatches:
> -
>   :Original: Documentation/process/submitting-patches.rst
>   
>   提交補丁:如何讓你的改動進入核心
> diff --git a/Documentation/translations/zh_TW/process/volatile-considered-harmful.rst b/Documentation/translations/zh_TW/process/volatile-considered-harmful.rst
> index edfc83f32672..a2384b60b874 100644
> --- a/Documentation/translations/zh_TW/process/volatile-considered-harmful.rst
> +++ b/Documentation/translations/zh_TW/process/volatile-considered-harmful.rst
> @@ -1,7 +1,5 @@
>   .. SPDX-License-Identifier: GPL-2.0
>   
> -.. _tw_volatile_considered_harmful:
> -
>   .. include:: ../disclaimer-zh_TW.rst
>   
>   :Original: :ref:`Documentation/process/volatile-considered-harmful.rst


^ permalink raw reply	[flat|nested] 3+ messages in thread

* Re: [PATCH] docs/zh_TW: remove top-level labels from process/
  2026-10-29 11:50 ` Dongliang Mu
@ 2026-10-29 12:13   ` Weijie Yuan
  0 siblings, 0 replies; 3+ messages in thread
From: Weijie Yuan @ 2026-10-29 12:13 UTC (permalink / raw)
  To: Dongliang Mu
  Cc: Jonathan Corbet, Shuah Khan, Randy Dunlap, Weijie Yuan,
	Chen-Yu Yeh, linux-doc, linux-kernel

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@wyuan.org>
> > 
> > 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!

^ permalink raw reply	[flat|nested] 3+ messages in thread

end of thread, other threads:[~2026-10-29 12:13 UTC | newest]

Thread overview: 3+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2026-10-29  9:26 [PATCH] docs/zh_TW: remove top-level labels from process/ Weijie Yuan
2026-10-29 11:50 ` Dongliang Mu
2026-10-29 12:13   ` Weijie Yuan

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®