[docs-scanner] Raspberry Pi OS deprecation notice contradicts table entry
Nobody has claimed this yet.
- Dominant language
- Markdown
- Stars
- 4.7k
- Forks
- 8.5k
- Avg merge
- 2d 18h
- Merged PRs (30d)
- 108
Description
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:
- Add a footnote or note next to the Raspberry Pi OS entry explaining the deprecation timeline
- Use a different symbol (like ❌ or 🚫) to indicate deprecated/end-of-life status
- Add a column note or table caption explaining what ⚠️ means in this context
- 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
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Read content/manuals/engine/install/raspberry-pi-os.md and _index.md, then inspect nearby table entries to understand how support warnings are represented. Update the Raspberry Pi OS 32-bit entry so the index clearly communicates the documented deprecation timeline while preserving the link. Done means the index and linked page no longer give conflicting impressions.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- docker, raspberry-pi
- Domain
- documentation
- Issue type
- Documentation
- Difficulty
- 2/5
- Estimated time
- 1-3 hours
- Activity status
- Active
- Clarity
- Mostly clear
- Newbie friendliness
- 74/100