Re: [PATCH 1/7] arm: docs: Move Arm documentation to Documentation/arch/

[Alexandre TORGUE <alexandre.torgue@foss.st.com>]

On 5/19/23 18:46, Jonathan Corbet wrote:
> Architecture-specific documentation is being moved into Documentation/arch/
> as a way of cleaning up the top-level documentation directory and making
> the docs hierarchy more closely match the source hierarchy.  Move
> Documentation/arch into arch/ and fix all documentation references.
> 
> Cc: Maxime Coquelin <mcoquelin.stm32@gmail.com>
> Cc: Alexandre Torgue <alexandre.torgue@foss.st.com>
> Cc: Chen-Yu Tsai <wens@csie.org>
> Cc: Jernej Skrabec <jernej.skrabec@gmail.com>
> Cc: Samuel Holland <samuel@sholland.org>
> Cc: Krzysztof Kozlowski <krzysztof.kozlowski@linaro.org>
> Cc: Alim Akhtar <alim.akhtar@samsung.com>
> Cc: Alex Shi <alexs@kernel.org>
> Cc: Yanteng Si <siyanteng@loongson.cn>
> Cc: linux-doc@vger.kernel.org
> Cc: linux-arm-kernel@lists.infradead.org
> Cc: linux-arch@vger.kernel.org
> Signed-off-by: Jonathan Corbet <corbet@lwn.net>
> ---

Acked-by: Alexandre TORGUE <alexandre.torgue@foss.st.com>


>   Documentation/{ => arch}/arm/arm.rst                          | 0
>   Documentation/{ => arch}/arm/booting.rst                      | 0
>   Documentation/{ => arch}/arm/cluster-pm-race-avoidance.rst    | 0
>   Documentation/{ => arch}/arm/features.rst                     | 0
>   Documentation/{ => arch}/arm/firmware.rst                     | 0
>   Documentation/{ => arch}/arm/google/chromebook-boot-flow.rst  | 0
>   Documentation/{ => arch}/arm/index.rst                        | 0
>   Documentation/{ => arch}/arm/interrupts.rst                   | 0
>   Documentation/{ => arch}/arm/ixp4xx.rst                       | 0
>   Documentation/{ => arch}/arm/kernel_mode_neon.rst             | 0
>   Documentation/{ => arch}/arm/kernel_user_helpers.rst          | 0
>   Documentation/{ => arch}/arm/keystone/knav-qmss.rst           | 0
>   Documentation/{ => arch}/arm/keystone/overview.rst            | 0
>   Documentation/{ => arch}/arm/marvell.rst                      | 0
>   Documentation/{ => arch}/arm/mem_alignment.rst                | 0
>   Documentation/{ => arch}/arm/memory.rst                       | 0
>   Documentation/{ => arch}/arm/microchip.rst                    | 0
>   Documentation/{ => arch}/arm/netwinder.rst                    | 0
>   Documentation/{ => arch}/arm/nwfpe/index.rst                  | 0
>   Documentation/{ => arch}/arm/nwfpe/netwinder-fpe.rst          | 0
>   Documentation/{ => arch}/arm/nwfpe/notes.rst                  | 0
>   Documentation/{ => arch}/arm/nwfpe/nwfpe.rst                  | 0
>   Documentation/{ => arch}/arm/nwfpe/todo.rst                   | 0
>   Documentation/{ => arch}/arm/omap/dss.rst                     | 0
>   Documentation/{ => arch}/arm/omap/index.rst                   | 0
>   Documentation/{ => arch}/arm/omap/omap.rst                    | 0
>   Documentation/{ => arch}/arm/omap/omap_pm.rst                 | 0
>   Documentation/{ => arch}/arm/porting.rst                      | 0
>   Documentation/{ => arch}/arm/pxa/mfp.rst                      | 0
>   Documentation/{ => arch}/arm/sa1100/assabet.rst               | 0
>   Documentation/{ => arch}/arm/sa1100/cerf.rst                  | 0
>   Documentation/{ => arch}/arm/sa1100/index.rst                 | 0
>   Documentation/{ => arch}/arm/sa1100/lart.rst                  | 0
>   Documentation/{ => arch}/arm/sa1100/serial_uart.rst           | 0
>   Documentation/{ => arch}/arm/samsung/bootloader-interface.rst | 0
>   .../{ => arch}/arm/samsung/clksrc-change-registers.awk        | 0
>   Documentation/{ => arch}/arm/samsung/gpio.rst                 | 0
>   Documentation/{ => arch}/arm/samsung/index.rst                | 0
>   Documentation/{ => arch}/arm/samsung/overview.rst             | 0
>   Documentation/{ => arch}/arm/setup.rst                        | 0
>   Documentation/{ => arch}/arm/spear/overview.rst               | 0
>   Documentation/{ => arch}/arm/sti/overview.rst                 | 0
>   Documentation/{ => arch}/arm/sti/stih407-overview.rst         | 0
>   Documentation/{ => arch}/arm/sti/stih418-overview.rst         | 0
>   Documentation/{ => arch}/arm/stm32/overview.rst               | 0
>   .../{ => arch}/arm/stm32/stm32-dma-mdma-chaining.rst          | 0
>   Documentation/{ => arch}/arm/stm32/stm32f429-overview.rst     | 0
>   Documentation/{ => arch}/arm/stm32/stm32f746-overview.rst     | 0
>   Documentation/{ => arch}/arm/stm32/stm32f769-overview.rst     | 0
>   Documentation/{ => arch}/arm/stm32/stm32h743-overview.rst     | 0
>   Documentation/{ => arch}/arm/stm32/stm32h750-overview.rst     | 0
>   Documentation/{ => arch}/arm/stm32/stm32mp13-overview.rst     | 0
>   Documentation/{ => arch}/arm/stm32/stm32mp151-overview.rst    | 0
>   Documentation/{ => arch}/arm/stm32/stm32mp157-overview.rst    | 0
>   Documentation/{ => arch}/arm/sunxi.rst                        | 0
>   Documentation/{ => arch}/arm/sunxi/clocks.rst                 | 0
>   Documentation/{ => arch}/arm/swp_emulation.rst                | 0
>   Documentation/{ => arch}/arm/tcm.rst                          | 0
>   Documentation/{ => arch}/arm/uefi.rst                         | 0
>   Documentation/{ => arch}/arm/vfp/release-notes.rst            | 0
>   Documentation/{ => arch}/arm/vlocks.rst                       | 0
>   Documentation/arch/index.rst                                  | 2 +-
>   Documentation/translations/zh_CN/arm/Booting                  | 4 ++--
>   Documentation/translations/zh_CN/arm/kernel_user_helpers.txt  | 4 ++--
>   64 files changed, 5 insertions(+), 5 deletions(-)
>   rename Documentation/{ => arch}/arm/arm.rst (100%)
>   rename Documentation/{ => arch}/arm/booting.rst (100%)
>   rename Documentation/{ => arch}/arm/cluster-pm-race-avoidance.rst (100%)
>   rename Documentation/{ => arch}/arm/features.rst (100%)
>   rename Documentation/{ => arch}/arm/firmware.rst (100%)
>   rename Documentation/{ => arch}/arm/google/chromebook-boot-flow.rst (100%)
>   rename Documentation/{ => arch}/arm/index.rst (100%)
>   rename Documentation/{ => arch}/arm/interrupts.rst (100%)
>   rename Documentation/{ => arch}/arm/ixp4xx.rst (100%)
>   rename Documentation/{ => arch}/arm/kernel_mode_neon.rst (100%)
>   rename Documentation/{ => arch}/arm/kernel_user_helpers.rst (100%)
>   rename Documentation/{ => arch}/arm/keystone/knav-qmss.rst (100%)
>   rename Documentation/{ => arch}/arm/keystone/overview.rst (100%)
>   rename Documentation/{ => arch}/arm/marvell.rst (100%)
>   rename Documentation/{ => arch}/arm/mem_alignment.rst (100%)
>   rename Documentation/{ => arch}/arm/memory.rst (100%)
>   rename Documentation/{ => arch}/arm/microchip.rst (100%)
>   rename Documentation/{ => arch}/arm/netwinder.rst (100%)
>   rename Documentation/{ => arch}/arm/nwfpe/index.rst (100%)
>   rename Documentation/{ => arch}/arm/nwfpe/netwinder-fpe.rst (100%)
>   rename Documentation/{ => arch}/arm/nwfpe/notes.rst (100%)
>   rename Documentation/{ => arch}/arm/nwfpe/nwfpe.rst (100%)
>   rename Documentation/{ => arch}/arm/nwfpe/todo.rst (100%)
>   rename Documentation/{ => arch}/arm/omap/dss.rst (100%)
>   rename Documentation/{ => arch}/arm/omap/index.rst (100%)
>   rename Documentation/{ => arch}/arm/omap/omap.rst (100%)
>   rename Documentation/{ => arch}/arm/omap/omap_pm.rst (100%)
>   rename Documentation/{ => arch}/arm/porting.rst (100%)
>   rename Documentation/{ => arch}/arm/pxa/mfp.rst (100%)
>   rename Documentation/{ => arch}/arm/sa1100/assabet.rst (100%)
>   rename Documentation/{ => arch}/arm/sa1100/cerf.rst (100%)
>   rename Documentation/{ => arch}/arm/sa1100/index.rst (100%)
>   rename Documentation/{ => arch}/arm/sa1100/lart.rst (100%)
>   rename Documentation/{ => arch}/arm/sa1100/serial_uart.rst (100%)
>   rename Documentation/{ => arch}/arm/samsung/bootloader-interface.rst (100%)
>   rename Documentation/{ => arch}/arm/samsung/clksrc-change-registers.awk (100%)
>   rename Documentation/{ => arch}/arm/samsung/gpio.rst (100%)
>   rename Documentation/{ => arch}/arm/samsung/index.rst (100%)
>   rename Documentation/{ => arch}/arm/samsung/overview.rst (100%)
>   rename Documentation/{ => arch}/arm/setup.rst (100%)
>   rename Documentation/{ => arch}/arm/spear/overview.rst (100%)
>   rename Documentation/{ => arch}/arm/sti/overview.rst (100%)
>   rename Documentation/{ => arch}/arm/sti/stih407-overview.rst (100%)
>   rename Documentation/{ => arch}/arm/sti/stih418-overview.rst (100%)
>   rename Documentation/{ => arch}/arm/stm32/overview.rst (100%)
>   rename Documentation/{ => arch}/arm/stm32/stm32-dma-mdma-chaining.rst (100%)
>   rename Documentation/{ => arch}/arm/stm32/stm32f429-overview.rst (100%)
>   rename Documentation/{ => arch}/arm/stm32/stm32f746-overview.rst (100%)
>   rename Documentation/{ => arch}/arm/stm32/stm32f769-overview.rst (100%)
>   rename Documentation/{ => arch}/arm/stm32/stm32h743-overview.rst (100%)
>   rename Documentation/{ => arch}/arm/stm32/stm32h750-overview.rst (100%)
>   rename Documentation/{ => arch}/arm/stm32/stm32mp13-overview.rst (100%)
>   rename Documentation/{ => arch}/arm/stm32/stm32mp151-overview.rst (100%)
>   rename Documentation/{ => arch}/arm/stm32/stm32mp157-overview.rst (100%)
>   rename Documentation/{ => arch}/arm/sunxi.rst (100%)
>   rename Documentation/{ => arch}/arm/sunxi/clocks.rst (100%)
>   rename Documentation/{ => arch}/arm/swp_emulation.rst (100%)
>   rename Documentation/{ => arch}/arm/tcm.rst (100%)
>   rename Documentation/{ => arch}/arm/uefi.rst (100%)
>   rename Documentation/{ => arch}/arm/vfp/release-notes.rst (100%)
>   rename Documentation/{ => arch}/arm/vlocks.rst (100%)
> 
> diff --git a/Documentation/arm/arm.rst b/Documentation/arch/arm/arm.rst
> similarity index 100%
> rename from Documentation/arm/arm.rst
> rename to Documentation/arch/arm/arm.rst
> diff --git a/Documentation/arm/booting.rst b/Documentation/arch/arm/booting.rst
> similarity index 100%
> rename from Documentation/arm/booting.rst
> rename to Documentation/arch/arm/booting.rst
> diff --git a/Documentation/arm/cluster-pm-race-avoidance.rst b/Documentation/arch/arm/cluster-pm-race-avoidance.rst
> similarity index 100%
> rename from Documentation/arm/cluster-pm-race-avoidance.rst
> rename to Documentation/arch/arm/cluster-pm-race-avoidance.rst
> diff --git a/Documentation/arm/features.rst b/Documentation/arch/arm/features.rst
> similarity index 100%
> rename from Documentation/arm/features.rst
> rename to Documentation/arch/arm/features.rst
> diff --git a/Documentation/arm/firmware.rst b/Documentation/arch/arm/firmware.rst
> similarity index 100%
> rename from Documentation/arm/firmware.rst
> rename to Documentation/arch/arm/firmware.rst
> diff --git a/Documentation/arm/google/chromebook-boot-flow.rst b/Documentation/arch/arm/google/chromebook-boot-flow.rst
> similarity index 100%
> rename from Documentation/arm/google/chromebook-boot-flow.rst
> rename to Documentation/arch/arm/google/chromebook-boot-flow.rst
> diff --git a/Documentation/arm/index.rst b/Documentation/arch/arm/index.rst
> similarity index 100%
> rename from Documentation/arm/index.rst
> rename to Documentation/arch/arm/index.rst
> diff --git a/Documentation/arm/interrupts.rst b/Documentation/arch/arm/interrupts.rst
> similarity index 100%
> rename from Documentation/arm/interrupts.rst
> rename to Documentation/arch/arm/interrupts.rst
> diff --git a/Documentation/arm/ixp4xx.rst b/Documentation/arch/arm/ixp4xx.rst
> similarity index 100%
> rename from Documentation/arm/ixp4xx.rst
> rename to Documentation/arch/arm/ixp4xx.rst
> diff --git a/Documentation/arm/kernel_mode_neon.rst b/Documentation/arch/arm/kernel_mode_neon.rst
> similarity index 100%
> rename from Documentation/arm/kernel_mode_neon.rst
> rename to Documentation/arch/arm/kernel_mode_neon.rst
> diff --git a/Documentation/arm/kernel_user_helpers.rst b/Documentation/arch/arm/kernel_user_helpers.rst
> similarity index 100%
> rename from Documentation/arm/kernel_user_helpers.rst
> rename to Documentation/arch/arm/kernel_user_helpers.rst
> diff --git a/Documentation/arm/keystone/knav-qmss.rst b/Documentation/arch/arm/keystone/knav-qmss.rst
> similarity index 100%
> rename from Documentation/arm/keystone/knav-qmss.rst
> rename to Documentation/arch/arm/keystone/knav-qmss.rst
> diff --git a/Documentation/arm/keystone/overview.rst b/Documentation/arch/arm/keystone/overview.rst
> similarity index 100%
> rename from Documentation/arm/keystone/overview.rst
> rename to Documentation/arch/arm/keystone/overview.rst
> diff --git a/Documentation/arm/marvell.rst b/Documentation/arch/arm/marvell.rst
> similarity index 100%
> rename from Documentation/arm/marvell.rst
> rename to Documentation/arch/arm/marvell.rst
> diff --git a/Documentation/arm/mem_alignment.rst b/Documentation/arch/arm/mem_alignment.rst
> similarity index 100%
> rename from Documentation/arm/mem_alignment.rst
> rename to Documentation/arch/arm/mem_alignment.rst
> diff --git a/Documentation/arm/memory.rst b/Documentation/arch/arm/memory.rst
> similarity index 100%
> rename from Documentation/arm/memory.rst
> rename to Documentation/arch/arm/memory.rst
> diff --git a/Documentation/arm/microchip.rst b/Documentation/arch/arm/microchip.rst
> similarity index 100%
> rename from Documentation/arm/microchip.rst
> rename to Documentation/arch/arm/microchip.rst
> diff --git a/Documentation/arm/netwinder.rst b/Documentation/arch/arm/netwinder.rst
> similarity index 100%
> rename from Documentation/arm/netwinder.rst
> rename to Documentation/arch/arm/netwinder.rst
> diff --git a/Documentation/arm/nwfpe/index.rst b/Documentation/arch/arm/nwfpe/index.rst
> similarity index 100%
> rename from Documentation/arm/nwfpe/index.rst
> rename to Documentation/arch/arm/nwfpe/index.rst
> diff --git a/Documentation/arm/nwfpe/netwinder-fpe.rst b/Documentation/arch/arm/nwfpe/netwinder-fpe.rst
> similarity index 100%
> rename from Documentation/arm/nwfpe/netwinder-fpe.rst
> rename to Documentation/arch/arm/nwfpe/netwinder-fpe.rst
> diff --git a/Documentation/arm/nwfpe/notes.rst b/Documentation/arch/arm/nwfpe/notes.rst
> similarity index 100%
> rename from Documentation/arm/nwfpe/notes.rst
> rename to Documentation/arch/arm/nwfpe/notes.rst
> diff --git a/Documentation/arm/nwfpe/nwfpe.rst b/Documentation/arch/arm/nwfpe/nwfpe.rst
> similarity index 100%
> rename from Documentation/arm/nwfpe/nwfpe.rst
> rename to Documentation/arch/arm/nwfpe/nwfpe.rst
> diff --git a/Documentation/arm/nwfpe/todo.rst b/Documentation/arch/arm/nwfpe/todo.rst
> similarity index 100%
> rename from Documentation/arm/nwfpe/todo.rst
> rename to Documentation/arch/arm/nwfpe/todo.rst
> diff --git a/Documentation/arm/omap/dss.rst b/Documentation/arch/arm/omap/dss.rst
> similarity index 100%
> rename from Documentation/arm/omap/dss.rst
> rename to Documentation/arch/arm/omap/dss.rst
> diff --git a/Documentation/arm/omap/index.rst b/Documentation/arch/arm/omap/index.rst
> similarity index 100%
> rename from Documentation/arm/omap/index.rst
> rename to Documentation/arch/arm/omap/index.rst
> diff --git a/Documentation/arm/omap/omap.rst b/Documentation/arch/arm/omap/omap.rst
> similarity index 100%
> rename from Documentation/arm/omap/omap.rst
> rename to Documentation/arch/arm/omap/omap.rst
> diff --git a/Documentation/arm/omap/omap_pm.rst b/Documentation/arch/arm/omap/omap_pm.rst
> similarity index 100%
> rename from Documentation/arm/omap/omap_pm.rst
> rename to Documentation/arch/arm/omap/omap_pm.rst
> diff --git a/Documentation/arm/porting.rst b/Documentation/arch/arm/porting.rst
> similarity index 100%
> rename from Documentation/arm/porting.rst
> rename to Documentation/arch/arm/porting.rst
> diff --git a/Documentation/arm/pxa/mfp.rst b/Documentation/arch/arm/pxa/mfp.rst
> similarity index 100%
> rename from Documentation/arm/pxa/mfp.rst
> rename to Documentation/arch/arm/pxa/mfp.rst
> diff --git a/Documentation/arm/sa1100/assabet.rst b/Documentation/arch/arm/sa1100/assabet.rst
> similarity index 100%
> rename from Documentation/arm/sa1100/assabet.rst
> rename to Documentation/arch/arm/sa1100/assabet.rst
> diff --git a/Documentation/arm/sa1100/cerf.rst b/Documentation/arch/arm/sa1100/cerf.rst
> similarity index 100%
> rename from Documentation/arm/sa1100/cerf.rst
> rename to Documentation/arch/arm/sa1100/cerf.rst
> diff --git a/Documentation/arm/sa1100/index.rst b/Documentation/arch/arm/sa1100/index.rst
> similarity index 100%
> rename from Documentation/arm/sa1100/index.rst
> rename to Documentation/arch/arm/sa1100/index.rst
> diff --git a/Documentation/arm/sa1100/lart.rst b/Documentation/arch/arm/sa1100/lart.rst
> similarity index 100%
> rename from Documentation/arm/sa1100/lart.rst
> rename to Documentation/arch/arm/sa1100/lart.rst
> diff --git a/Documentation/arm/sa1100/serial_uart.rst b/Documentation/arch/arm/sa1100/serial_uart.rst
> similarity index 100%
> rename from Documentation/arm/sa1100/serial_uart.rst
> rename to Documentation/arch/arm/sa1100/serial_uart.rst
> diff --git a/Documentation/arm/samsung/bootloader-interface.rst b/Documentation/arch/arm/samsung/bootloader-interface.rst
> similarity index 100%
> rename from Documentation/arm/samsung/bootloader-interface.rst
> rename to Documentation/arch/arm/samsung/bootloader-interface.rst
> diff --git a/Documentation/arm/samsung/clksrc-change-registers.awk b/Documentation/arch/arm/samsung/clksrc-change-registers.awk
> similarity index 100%
> rename from Documentation/arm/samsung/clksrc-change-registers.awk
> rename to Documentation/arch/arm/samsung/clksrc-change-registers.awk
> diff --git a/Documentation/arm/samsung/gpio.rst b/Documentation/arch/arm/samsung/gpio.rst
> similarity index 100%
> rename from Documentation/arm/samsung/gpio.rst
> rename to Documentation/arch/arm/samsung/gpio.rst
> diff --git a/Documentation/arm/samsung/index.rst b/Documentation/arch/arm/samsung/index.rst
> similarity index 100%
> rename from Documentation/arm/samsung/index.rst
> rename to Documentation/arch/arm/samsung/index.rst
> diff --git a/Documentation/arm/samsung/overview.rst b/Documentation/arch/arm/samsung/overview.rst
> similarity index 100%
> rename from Documentation/arm/samsung/overview.rst
> rename to Documentation/arch/arm/samsung/overview.rst
> diff --git a/Documentation/arm/setup.rst b/Documentation/arch/arm/setup.rst
> similarity index 100%
> rename from Documentation/arm/setup.rst
> rename to Documentation/arch/arm/setup.rst
> diff --git a/Documentation/arm/spear/overview.rst b/Documentation/arch/arm/spear/overview.rst
> similarity index 100%
> rename from Documentation/arm/spear/overview.rst
> rename to Documentation/arch/arm/spear/overview.rst
> diff --git a/Documentation/arm/sti/overview.rst b/Documentation/arch/arm/sti/overview.rst
> similarity index 100%
> rename from Documentation/arm/sti/overview.rst
> rename to Documentation/arch/arm/sti/overview.rst
> diff --git a/Documentation/arm/sti/stih407-overview.rst b/Documentation/arch/arm/sti/stih407-overview.rst
> similarity index 100%
> rename from Documentation/arm/sti/stih407-overview.rst
> rename to Documentation/arch/arm/sti/stih407-overview.rst
> diff --git a/Documentation/arm/sti/stih418-overview.rst b/Documentation/arch/arm/sti/stih418-overview.rst
> similarity index 100%
> rename from Documentation/arm/sti/stih418-overview.rst
> rename to Documentation/arch/arm/sti/stih418-overview.rst
> diff --git a/Documentation/arm/stm32/overview.rst b/Documentation/arch/arm/stm32/overview.rst
> similarity index 100%
> rename from Documentation/arm/stm32/overview.rst
> rename to Documentation/arch/arm/stm32/overview.rst
> diff --git a/Documentation/arm/stm32/stm32-dma-mdma-chaining.rst b/Documentation/arch/arm/stm32/stm32-dma-mdma-chaining.rst
> similarity index 100%
> rename from Documentation/arm/stm32/stm32-dma-mdma-chaining.rst
> rename to Documentation/arch/arm/stm32/stm32-dma-mdma-chaining.rst
> diff --git a/Documentation/arm/stm32/stm32f429-overview.rst b/Documentation/arch/arm/stm32/stm32f429-overview.rst
> similarity index 100%
> rename from Documentation/arm/stm32/stm32f429-overview.rst
> rename to Documentation/arch/arm/stm32/stm32f429-overview.rst
> diff --git a/Documentation/arm/stm32/stm32f746-overview.rst b/Documentation/arch/arm/stm32/stm32f746-overview.rst
> similarity index 100%
> rename from Documentation/arm/stm32/stm32f746-overview.rst
> rename to Documentation/arch/arm/stm32/stm32f746-overview.rst
> diff --git a/Documentation/arm/stm32/stm32f769-overview.rst b/Documentation/arch/arm/stm32/stm32f769-overview.rst
> similarity index 100%
> rename from Documentation/arm/stm32/stm32f769-overview.rst
> rename to Documentation/arch/arm/stm32/stm32f769-overview.rst
> diff --git a/Documentation/arm/stm32/stm32h743-overview.rst b/Documentation/arch/arm/stm32/stm32h743-overview.rst
> similarity index 100%
> rename from Documentation/arm/stm32/stm32h743-overview.rst
> rename to Documentation/arch/arm/stm32/stm32h743-overview.rst
> diff --git a/Documentation/arm/stm32/stm32h750-overview.rst b/Documentation/arch/arm/stm32/stm32h750-overview.rst
> similarity index 100%
> rename from Documentation/arm/stm32/stm32h750-overview.rst
> rename to Documentation/arch/arm/stm32/stm32h750-overview.rst
> diff --git a/Documentation/arm/stm32/stm32mp13-overview.rst b/Documentation/arch/arm/stm32/stm32mp13-overview.rst
> similarity index 100%
> rename from Documentation/arm/stm32/stm32mp13-overview.rst
> rename to Documentation/arch/arm/stm32/stm32mp13-overview.rst
> diff --git a/Documentation/arm/stm32/stm32mp151-overview.rst b/Documentation/arch/arm/stm32/stm32mp151-overview.rst
> similarity index 100%
> rename from Documentation/arm/stm32/stm32mp151-overview.rst
> rename to Documentation/arch/arm/stm32/stm32mp151-overview.rst
> diff --git a/Documentation/arm/stm32/stm32mp157-overview.rst b/Documentation/arch/arm/stm32/stm32mp157-overview.rst
> similarity index 100%
> rename from Documentation/arm/stm32/stm32mp157-overview.rst
> rename to Documentation/arch/arm/stm32/stm32mp157-overview.rst
> diff --git a/Documentation/arm/sunxi.rst b/Documentation/arch/arm/sunxi.rst
> similarity index 100%
> rename from Documentation/arm/sunxi.rst
> rename to Documentation/arch/arm/sunxi.rst
> diff --git a/Documentation/arm/sunxi/clocks.rst b/Documentation/arch/arm/sunxi/clocks.rst
> similarity index 100%
> rename from Documentation/arm/sunxi/clocks.rst
> rename to Documentation/arch/arm/sunxi/clocks.rst
> diff --git a/Documentation/arm/swp_emulation.rst b/Documentation/arch/arm/swp_emulation.rst
> similarity index 100%
> rename from Documentation/arm/swp_emulation.rst
> rename to Documentation/arch/arm/swp_emulation.rst
> diff --git a/Documentation/arm/tcm.rst b/Documentation/arch/arm/tcm.rst
> similarity index 100%
> rename from Documentation/arm/tcm.rst
> rename to Documentation/arch/arm/tcm.rst
> diff --git a/Documentation/arm/uefi.rst b/Documentation/arch/arm/uefi.rst
> similarity index 100%
> rename from Documentation/arm/uefi.rst
> rename to Documentation/arch/arm/uefi.rst
> diff --git a/Documentation/arm/vfp/release-notes.rst b/Documentation/arch/arm/vfp/release-notes.rst
> similarity index 100%
> rename from Documentation/arm/vfp/release-notes.rst
> rename to Documentation/arch/arm/vfp/release-notes.rst
> diff --git a/Documentation/arm/vlocks.rst b/Documentation/arch/arm/vlocks.rst
> similarity index 100%
> rename from Documentation/arm/vlocks.rst
> rename to Documentation/arch/arm/vlocks.rst
> diff --git a/Documentation/arch/index.rst b/Documentation/arch/index.rst
> index 80ee31016584..21e3d0b61004 100644
> --- a/Documentation/arch/index.rst
> +++ b/Documentation/arch/index.rst
> @@ -10,7 +10,7 @@ implementation.
>      :maxdepth: 2
>   
>      arc/index
> -   ../arm/index
> +   arm/index
>      ../arm64/index
>      ia64/index
>      ../loongarch/index
> diff --git a/Documentation/translations/zh_CN/arm/Booting b/Documentation/translations/zh_CN/arm/Booting
> index 5ecea0767893..f18585156b67 100644
> --- a/Documentation/translations/zh_CN/arm/Booting
> +++ b/Documentation/translations/zh_CN/arm/Booting
> @@ -1,4 +1,4 @@
> -Chinese translated version of Documentation/arm/booting.rst
> +Chinese translated version of Documentation/arch/arm/booting.rst
>   
>   If you have any comment or update to the content, please contact the
>   original document maintainer directly.  However, if you have a problem
> @@ -9,7 +9,7 @@ or if there is a problem with the translation.
>   Maintainer: Russell King <linux@arm.linux.org.uk>
>   Chinese maintainer: Fu Wei <tekkamanninja@gmail.com>
>   ---------------------------------------------------------------------
> -Documentation/arm/booting.rst 的中文翻译
> +Documentation/arch/arm/booting.rst 的中文翻译
>   
>   如果想评论或更新本文的内容，请直接联系原文档的维护者。如果你使用英文
>   交流有困难的话，也可以向中文版维护者求助。如果本翻译更新不及时或者翻
> diff --git a/Documentation/translations/zh_CN/arm/kernel_user_helpers.txt b/Documentation/translations/zh_CN/arm/kernel_user_helpers.txt
> index 99af4363984d..018eb7d54233 100644
> --- a/Documentation/translations/zh_CN/arm/kernel_user_helpers.txt
> +++ b/Documentation/translations/zh_CN/arm/kernel_user_helpers.txt
> @@ -1,4 +1,4 @@
> -Chinese translated version of Documentation/arm/kernel_user_helpers.rst
> +Chinese translated version of Documentation/arch/arm/kernel_user_helpers.rst
>   
>   If you have any comment or update to the content, please contact the
>   original document maintainer directly.  However, if you have a problem
> @@ -10,7 +10,7 @@ Maintainer: Nicolas Pitre <nicolas.pitre@linaro.org>
>   		Dave Martin <dave.martin@linaro.org>
>   Chinese maintainer: Fu Wei <tekkamanninja@gmail.com>
>   ---------------------------------------------------------------------
> -Documentation/arm/kernel_user_helpers.rst 的中文翻译
> +Documentation/arch/arm/kernel_user_helpers.rst 的中文翻译
>   
>   如果想评论或更新本文的内容，请直接联系原文档的维护者。如果你使用英文
>   交流有困难的话，也可以向中文版维护者求助。如果本翻译更新不及时或者翻