Re: [PATCH v3 00/16] docs/zh_TW: localize terminology and sync process/ documents

[葉宸佑]

On Wed, Aug 12, 2026 at 09:42:32PM +0800, Weijie Yuan wrote:
> I have no more comments for version 3 as all my issues in v2 have been
> resolved.

Thanks for working through all sixteen of them -- the series is
noticeably better for it.

> And Dongliang's comments seem to be non-blocking, which may belong to
> another series later.

Agreed. Dongliang, if you are happy with that, I will send the
量化/啟發式 corrections as a separate patch covering both zh_CN and
zh_TW once this lands, as you suggested.

> If so, which tree would you prefer this series to go through, assuming
> there are no issues with it?

Either works for me. Since the series only touches zh_TW and the review
is done, taking it directly through the docs tree would save a hop --
but Alex kindly offered to route zh_TW patches through his tree earlier,
so I am equally happy to go that way if that is the established path.

Jon, Alex: whichever is less work for you.

Chen-Yu

Weijie Yuan <wy@xxxxxxxxx> 於 2026年8月12日週三 下午9:42寫道：
>
> On Fri, Aug 07, 2026 at 02:19:33AM +0800, Chen-Yu Yeh wrote:
> > The zh_TW (Traditional Chinese) translations were originally converted
> > from the zh_CN tree, so they still use mainland Chinese terminology
> > (e.g. 內核, 軟件, 接口) that reads unnatural to Taiwanese readers, and
> > most of the process/ documents have fallen behind their English
> > originals.
> >
> > This series localizes the terminology of the existing zh_TW process/
> > documents to Taiwanese Mandarin and, in the same pass, syncs each
> > document with its current English original, so that the "update to
> > commit" markers stay honest for tools/docs/checktransupdate.py.
> >
> > Each patch covers one document and does both the terminology
> > localization and the content sync for it. Notable content syncs
> > include:
> >
> >   - code-of-conduct-interpretation: new "Enforcement for Unacceptable
> >     Behavior" section and updated TAB voting language
> >   - stable-kernel-rules: retranslated from the heavily restructured
> >     English text (three submission options, stable tag variants)
> >   - submitting-patches: interleaved-reply etiquette, reworked Acked-by
> >     semantics, tagging-people permission rules, Assisted-by:, canonical
> >     patch format subsections and the b4 tooling section
> >   - embargoed-hardware-issues: "Early access" section and the current
> >     ambassadors list
> >   - index: mirrors the reworked English process index layout
> >   - programming-language: Rust is no longer experimental
> >
> > The final patch adds Documentation/translations/zh_TW/glossary.rst,
> > which documents the terminology mapping used across the series (with
> > zh_CN equivalents for cross-reference) so that reviewers can check the
> > replacements against a single reference, and future translations can
> > stay consistent.
> >
> > A short summary of the main mappings (English / zh_TW / old zh_CN-style):
> >
> >   kernel      核心   (內核)      software    軟體   (軟件)
> >   interface   介面   (接口)      memory      記憶體 (內存)
> >   process     行程   (進程)      queue       佇列   (隊列)
> >   network     網路   (網絡)      server      伺服器 (服務器)
> >   default     預設   (默認)      user        使用者 (用戶)
> >   code        程式碼 (代碼)      file        檔案   (文件)
> >   community   社群   (社區)      documentation 文件 (文檔)
> >
> > On tooling: this series was prepared with LLM assistance -- an
> > assistant drafted the initial localization of each document and the
> > glossary, and I then reviewed every line by hand, checking each
> > terminology choice as a native speaker, verifying the "update to
> > commit" baselines against git log, and building the docs. That review
> > is where the substantive fixes came from, including the two glossary
> > corrections below. The patches carry Assisted-by: trailers
> > accordingly.
> >
> > Two items are deliberately left for after this series, as noted by
> > Weijie during review: a legal disclaimer for the DCO translation
> > (which affects all locales), and the rendering of "Linux Foundation
> > Fellow".
> >
> > Changes since v2:
> >   - Collected review tags; every patch except 2.Process now carries
> >     Weijie Yuan's Reviewed-by or Acked-by. The tag for 2.Process has
> >     simply not arrived yet.
> >   - Added an Assisted-by: trailer to every patch, per
> >     Documentation/process/coding-assistants.rst.
> >   - glossary: corrected two entries in the zh_CN reference column
> >     (建置 -> 构建, 账户 -> 帐户) after checking every term against
> >     Documentation/translations/zh_CN/ by occurrence count, and added a
> >     note recording that provenance (Alex Shi).
> >   - glossary: documented the CJK/ASCII spacing convention.
> >   - code-of-conduct-interpretation: two wording improvements in the
> >     "Enforcement for Unacceptable Behavior" section (加以糾正 instead of
> >     作出彌補, and 對這類報告進行調查並予以處理 instead of 調查並解決
> >     這些報告) (Weijie Yuan).
> >   - 2.Process: dropped the space in 維護 staging樹, following the
> >     CJK/ASCII spacing rule now documented in the glossary. The zh_TW
> >     tree is 2581 occurrences without a space to 721 with (Weijie Yuan).
>
>
> I have no more comments for version 3 as all my issues in v2 have been
> resolved.
>
> And Dongliang's comments seem to be non-blocking, which may belong to
> another series later.
>
> If everyone is happy with v3, can we declare victory for this series?
>
> If so, which tree would you prefer this series to go through, assuming there
> are no issues with it?
>
> Thanks.