Clarify Raspberry Pi 32 bit deprecation (#23514)

- follow up to: #23489

<!--Delete sections as needed -->

## Description

<!-- Tell us what you did and why -->

## Related issues or tickets

<!-- Related issues, pull requests, or Jira tickets -->

## Reviews

<!-- Notes for reviewers here -->
<!-- List applicable reviews (optionally @tag reviewers) -->

- [ ] Technical review
- [ ] Editorial review
- [ ] Product review

Signed-off-by: Paweł Gronowski <[email protected]>

Author: vvoland

content/manuals/engine/install/_index.md

@@ -47,7 +47,7 @@ Click on a platform's link to view the relevant installation procedure.
 | [CentOS](centos.md)                            |       ✅       |       ✅        |              |   ✅    |       |
 | [Debian](debian.md)                            |       ✅       |       ✅        |      ✅      |   ✅    |       |
 | [Fedora](fedora.md)                            |       ✅       |       ✅        |              |   ✅    |       |
-| [Raspberry Pi OS (32-bit)](raspberry-pi-os.md) |                |                 |      ✅      |         |       |
+| [Raspberry Pi OS (32-bit)](raspberry-pi-os.md) |                |                 |      ⚠️      |         |       |
 | [RHEL](rhel.md)                                |       ✅       |       ✅        |              |         |  ✅   |
 | [SLES](sles.md)                                |                |                 |              |         |  ❌   |
 | [Ubuntu](ubuntu.md)                            |       ✅       |       ✅        |      ✅      |   ✅    |  ✅   |

content/manuals/engine/install/debian.md

@@ -39,15 +39,14 @@ To get started with Docker Engine on Debian, make sure you
 
 ### OS requirements
 
-To install Docker Engine, you need the 64-bit version of one of these Debian
-versions:
+To install Docker Engine, you need one of these Debian versions:
 
 - Debian Trixie 13 (stable)
 - Debian Bookworm 12 (oldstable)
 - Debian Bullseye 11 (oldoldstable)
 
-Docker Engine for Debian is compatible with x86_64 (or amd64), armhf, arm64,
-and ppc64le (ppc64el) architectures.
+Docker Engine for Debian is compatible with x86_64 (or amd64), armhf (arm/v7),
+arm64, and ppc64le (ppc64el) architectures.
 
 ### Uninstall old versions
 

content/manuals/engine/install/raspberry-pi-os.md

@@ -15,11 +15,19 @@ download-url-base: https://download.docker.com/linux/raspbian
 
 > [!WARNING]
 >
-> Raspberry Pi OS 32-bit (armhf) will soon be deprecated. Starting with Docker Engine v29,
-> new major versions will no longer provide packages for Raspberry Pi OS 32-bit (armhf).
+> **Raspberry Pi OS 32-bit (armhf) Deprecation**
 >
-> It is recommended to migrate to the 64-bit version of Raspberry Pi OS, which
-> is supported and follows the [Debian installation instructions](debian.md).
+> Docker Engine v28 will be the last major version to support Raspberry Pi OS 32-bit (armhf).
+> Starting with Docker Engine v29, new major versions will no longer provide packages for Raspberry Pi OS 32-bit (armhf).
+>
+> **Migration options**
+> - **64-bit ARM:** Install the Debian `arm64` packages (fully supported). See the
+>   [Debian installation instructions](debian.md).
+> - **32-bit ARM (v7):** Install the Debian `armhf` packages (targets ARMv7 CPUs).
+>
+> **Note:** Older devices based on the ARMv6 architecture are no longer supported by official packages, including:
+> - Raspberry Pi 1 (Model A/B/A+/B+)
+> - Raspberry Pi Zero and Zero W
 
 To get started with Docker Engine on Raspberry Pi OS, make sure you
 [meet the prerequisites](#prerequisites), and then follow the
@@ -59,12 +67,15 @@ To install Docker Engine, you need one of the following OS versions:
 
 > [!WARNING]
 >
-> Support for 32-bit (armhf) Raspberry Pi OS will soon end. Docker Engine versions
-> prior to v29 will continue to work, but new major versions starting with
-> v29 will no longer provide 32-bit packages.
+> Docker Engine v28 is the last major version to support Raspberry Pi OS 32-bit (armhf). Starting with v29,
+> no new packages will be provided for 32-bit Raspberry Pi OS.
+>
+> Migration options:
+> - 64-bit ARM: use Debian `arm64` packages; see the [Debian installation instructions](debian.md).
+> - 32-bit ARM (v7): use Debian `armhf` packages (targets ARMv7 CPUs).
 >
-> Switch to 64-bit Raspberry Pi OS and follow
-> the [Debian installation instructions](debian.md) for continued support.
+> Note: ARMv6-based devices (Raspberry Pi 1 models and Raspberry Pi Zero/Zero W) are not supported by
+> official packages.
 
 ### Uninstall old versions
 

content/manuals/engine/release-notes/28.md

@@ -36,6 +36,20 @@ For a full list of pull requests and changes in this release, refer to the relev
 - [docker/cli, 28.5.0 milestone](https://github.com/docker/cli/issues?q=is%3Aclosed+milestone%3A28.5.0)
 - [moby/moby, 28.5.0 milestone](https://github.com/moby/moby/issues?q=is%3Aclosed+milestone%3A28.5.0)
 
+> [!WARNING]
+> **Raspberry Pi OS 32-bit (armhf) Deprecation**
+>
+> Docker Engine v28 will be the last major version to support Raspberry Pi OS 32-bit (armhf).
+> Starting with Docker Engine v29, new major versions will **no longer provide packages** for Raspberry Pi OS 32-bit (armhf).
+>
+> #### Migration options
+> - **64-bit ARM:** Install the Debian `arm64` packages (fully supported).
+> - **32-bit ARM (v7):** Install the Debian `armhf` packages (targets ARMv7 CPUs).
+>
+> **Note:** Older devices based on the ARMv6 architecture are no longer supported by official packages, including:
+> - Raspberry Pi 1 (Model A/B/A+/B+)
+> - Raspberry Pi Zero and Zero W
+
 ### Bug fixes and enhancements
 
 - Don't print warnings in `docker info` for broken symlinks in CLI-plugin directories. [docker/cli#6476](https://github.com/docker/cli/pull/6476)
@@ -905,5 +919,3 @@ For a full list of pull requests and changes in this release, refer to the relev
 - `pkg/directory.Size()` function is deprecated, and will be removed in the next release. [moby/moby#48057](https://github.com/moby/moby/pull/48057)
 - `registry`: Deprecate `APIEndpoint.TrimHostName`; hostname is now trimmed unconditionally for remote names. This field will be removed in the next release. [moby/moby#49005](https://github.com/moby/moby/pull/49005)
 - `allow-nondistributable-artifacts` field in `daemon.json`. Setting either option will no longer take effect, but a deprecation warning log is added to raise awareness about the deprecation. This warning is planned to become an error in the next release. [moby/moby#49065](https://github.com/moby/moby/pull/49065)
-
-