Re: [PATCH] docs/zh_TW: remove the unreachable plain-text translations

[Weijie Yuan]

On 2026-09-29 21:11:07 +0800, Chen-Yu Yeh <chenyou910331@xxxxxxxxx> wrote:

> These nine files predate the move of the documentation to
> reStructuredText.  Sphinx only reads .rst sources, so none of them is
> part of the built documentation, and nothing in the zh_TW tree refers to
> them; they can only be found by browsing the source tree.
> 
>   zh_TW file                          English original
>   IRQ.txt                             core-api/irq/index.rst
>   io_ordering.txt                     driver-api/io_ordering.rst
>   arch/arm/Booting                    arch/arm/booting.rst
>   arch/arm/kernel_user_helpers.txt    arch/arm/kernel_user_helpers.rst
>   arch/arm64/booting.txt              arch/arm64/booting.rst
>   arch/arm64/legacy_instructions.txt  arch/arm64/legacy_instructions.rst
>   arch/arm64/memory.txt               arch/arm64/memory.rst
>   arch/arm64/silicon-errata.txt       arch/arm64/silicon-errata.rst
>   arch/arm64/tagged-pointers.txt      arch/arm64/tagged-pointers.rst
> 
> Beyond the format, two of them no longer line up with the English tree
> at all: core-api/irq/index.rst is now only a toctree, the prose IRQ.txt
> translates having moved to core-api/irq/concepts.rst, and
> io_ordering.txt sits at the top level although its original lives under
> driver-api/.
> 
> As proposed in the zh_TW scope discussion and agreed there, remove them
> rather than convert them.  arch/arm/Booting was also listed in the
> proposal as a translation whose original had moved; being one of these
> files, it is removed rather than relocated.
> 
> Link: https://lore.kernel.org/linux-doc/CAKspUhJAbCWoxgh2eq8R5g_MiNK=oXgKPUWqGOpHh0w1-Fv74A@xxxxxxxxxxxxxx/
> Link: https://lore.kernel.org/linux-doc/ap5xEtMdwXS8Pvcf@xxxxxxxxx/
> Signed-off-by: Chen-Yu Yeh <chenyou910331@xxxxxxxxx>
> ---
> This applies on top of v2 of the contact-block cleanup:
>   https://lore.kernel.org/linux-doc/20260929115956.229610-1-chenyou910331@xxxxxxxxx/
> 
> That series still edits IRQ.txt, io_ordering.txt and the arch/arm{,64}
> plain-text files (3/7 and 7/7) so that it stands on its own; once this
> patch lands those hunks are moot.  That also answers Jon's question on
> v1 7/7 about handling the old files together with the wider update:
> they are removed here instead.

So please don't forget to check the sequence when applying this. :)

Tested with 'make cleandocs && make htmldocs', no extra warnings caused.

Acked-by: Weijie Yuan <wy@xxxxxxxxx>

Thanks.