Re: [PATCH 01/16] docs/zh_TW: process: localize terminology in 7.AdvancedTopics.rst

From: 葉宸佑

Date: Wed Jul 22 2026 - 09:45:22 EST


On Wed, Jul 22, 2026 at 01:56:46PM +0800, Weijie Yuan wrote:
> "免费的BitKeeper替代品" should be "自由的BitKeeper替代品"
> The text above is about proprietary 专有的/專有的, so here should be
> 自由的.

Good catch, you are right -- the sentence contrasts with the
proprietary Bitkeeper, so this is free-as-in-freedom and should be
自由的, not 免費的. I made this correction in 1.Intro (免费软件 →
自由軟體) but missed this instance in 7.AdvancedTopics. I will fix it
in v2, and can send an incremental patch for the same issue in zh_CN
afterwards as you suggested.

> Should we wrap lines earlier throughout the series?

Fair point. Some Taiwanese terms are one character longer than their
zh_CN counterparts (程式碼 vs 代碼, 使用者 vs 用戶), so a few lines
grew past a comfortable width without being reflowed. I will reflow the
affected paragraphs in v2 following the zh_CN how-to you linked, and
the long license-rules lines you pointed out on 04/16 will be wrapped
in the same pass.

To keep this reviewable, I plan to collect everyone's comments first
and then send a single v2 addressing them together, rather than
respinning per comment. Please let me know if you would prefer
otherwise.

Thanks a lot for the careful review.

Chen-Yu

Weijie Yuan <wy@xxxxxxxxx> 於 2026年7月22日週三 下午4:48寫道:
>
> On Wed, Jul 22, 2026 at 05:55:27AM +0800, Chen-Yu Yeh wrote:
> > 審閱補丁
> > --------
> >
> > -一些讀者顯然會反對將本節與“高級主題”放在一起,因爲即使是剛開始的內核開發人員
> > -也應該審閱補丁。當然,沒有比查看其他人發佈的代碼更好的方法來學習如何在內核環境
> > -中編程了。此外,審閱者永遠供不應求;通過審閱代碼,您可以對整個流程做出重大貢獻。
> > +一些讀者顯然會反對將本節與“進階主題”放在一起,因為即使是剛開始的核心開發人員
> > +也應該審閱補丁。當然,沒有比查看其他人發布的程式碼更好的方法來學習如何在核心環境
> > +中撰寫程式了。此外,審閱者永遠供不應求;透過審閱程式碼,您可以對整個流程做出重大貢獻。
> >
> > -審查代碼可能是一副令人生畏的圖景,特別是對一個新的內核開發人員來說,他們
> > -可能會對公開詢問代碼感到緊張,而這些代碼是由那些有更多經驗的人發佈的。不過,
> > -即使是最有經驗的開發人員編寫的代碼也可以得到改進。也許對(所有)審閱者最好
> > +審查程式碼可能是一副令人生畏的圖景,特別是對一個新的核心開發人員來說,他們
> > +可能會對公開詢問程式碼感到緊張,而這些程式碼是由那些有更多經驗的人發布的。不過,
> > +即使是最有經驗的開發人員編寫的程式碼也可以得到改進。也許對(所有)審閱者最好
> > 的建議是:把審閱評論當成問題而不是批評。詢問“在這條路徑中如何釋放鎖?”
> > -總是比說“這裏的鎖是錯誤的”更好。
> > +總是比說“這裡的鎖是錯誤的”更好。
> >
> > -不同的開發人員將從不同的角度審查代碼。部分人會主要關注代碼風格以及代碼行是
> > -否有尾隨空格。其他人會主要關注補丁作爲一個整體實現的變更是否對內核有好處。
> > -同時也有人會檢查是否存在鎖問題、堆棧使用過度、可能的安全問題、在其他地方
> > -發現的代碼重複、足夠的文檔、對性能的不利影響、用戶空間ABI更改等。所有類型
> > -的檢查,只要它們能引導更好的代碼進入內核,都是受歡迎和值得的。
> > +不同的開發人員將從不同的角度審查程式碼。部分人會主要關注程式碼風格以及程式碼行是
> > +否有尾隨空格。其他人會主要關注補丁作為一個整體實作的變更是否對核心有好處。
> > +同時也有人會檢查是否存在鎖問題、堆疊使用過度、可能的安全問題、在其他地方
> > +發現的程式碼重複、足夠的文件、對效能的不利影響、使用者空間ABI更改等。所有類型
> > +的檢查,只要它們能引導更好的程式碼進入核心,都是受歡迎和值得的。
>
> Should we wrap lines earlier throughout the series? After the certain
> terminology was changed, many lines became longer but were not reflowed.
>
> Just a thought. I'am also fine with current changes.
>
> Thanks.
>
> See:
>
> https://docs.kernel.org/translations/zh_CN/how-to.html#id9
> https://docs.kernel.org/translations/zh_CN/how-to.html#id10