Re: [PATCH 03/25] docs/zh_TW: process: sync 4.Coding.rst with the English original

[Weijie Yuan <wy@wyuan.org>]

On Fri, Nov 06, 2026 at 07:31:18PM +0800, Chen-Yu Yeh wrote:
> -內核長期以來都有其標準的代碼風格，如
> -:ref:`Documentation/translations/zh_CN/process/coding-style.rst <tw_codingstyle>`
> -中所述。在多數時候，該文檔中描述的準則至多被認爲是建議性的。因此，內核中存在
> -大量不符合代碼風格準則的代碼。這種代碼的存在會給內核開發人員帶來兩方面的危害。
> +核心長期以來都有其標準的程式碼風格，如
> +:ref:`Documentation/process/coding-style.rst <tw_codingstyle>` 中所述。在其中
> +大部分時間裡，該文件中描述的準則至多被認為是建議性的。因此，核心中存在大量不
> +符合程式碼風格準則的程式碼。這種程式碼的存在會給核心開發人員帶來兩方面的危害。

Sorry, but wait a minute.

You used <tw_codingstyle> label here, but after rendering, the html
output is still "Documentation/process/coding-style.rst", which is
pointing to the zh-tw translation, not the original one. So it is
inconsistent, right?

During my review of these patches, I didn't pay close attention to this
point. I'm so sorry. I originally thought that the compilation of Sphinx
would have pointed out the problem like this, but it turned out that I
had misunderstood the grammar of this "ref". Therefore I can see that
there're some instances in this serie doing like this.

I suggest that in this series, either use the full path to refer to a
file directly, or stick to the discouraged writing style and wait until
once these two series are completed, we can then carry out a thorough
cleanup. What do you think?

Regarding the "ref" of one specific section, I remember that it could be
referred to using a relative path, and with a label?

So please drop my review trailer, or directly point out that I'm
misunderstanding this again.

Thanks.