Skip to content

[docs-scanner] Raspberry Pi OS deprecation notice contradicts table entry #25879

Description

@docker-agent

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

Issue

The deprecation warning at the top of the page states that Docker Engine v28 is the last major version to support Raspberry Pi OS 32-bit (armhf), but the main index page (_index.md) shows Raspberry Pi OS with a ⚠️ warning symbol in the architecture support table, which typically indicates partial or limited support rather than deprecated/end-of-life status.

From raspberry-pi-os.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).

From _index.md table:

| [Raspberry Pi OS (32-bit)](raspberry-pi-os.md) |                |                 |      ⚠️      |         |       |

Why this matters

A reader looking at the main installation index sees the ⚠️ symbol for Raspberry Pi OS 32-bit support, which suggests caution but not imminent deprecation. When they click through to the Raspberry Pi OS page, they discover that support is actually ending in the next major version. This inconsistency could lead users to start new projects on a platform that's about to lose support.

The ⚠️ symbol is used elsewhere in the table (like for other platforms with full support), so it doesn't clearly communicate "deprecated" or "end-of-life" status.

Suggested fix

Update the _index.md table to more clearly indicate the deprecated status of Raspberry Pi OS 32-bit. Options:

  1. Add a footnote or note next to the Raspberry Pi OS entry explaining the deprecation timeline
  2. Use a different symbol (like ❌ or 🚫) to indicate deprecated/end-of-life status
  3. Add a column note or table caption explaining what ⚠️ means in this context
  4. Remove Raspberry Pi OS from the main table and add a separate "Deprecated platforms" section

The goal is to make the deprecation status immediately visible from the main index page so users don't start new projects on a platform losing support.


Found by nightly documentation quality scanner

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions