docker / docker/docs

Confusing for RasPi 32bit

Open Beginner friendly
#26,082 1 comment 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

status/triage
Dominant language
Markdown
Stars
4.7k
Forks
8.5k
Avg merge
2d 18h
Merged PRs (30d)
108

Description

Is this a docs issue?
  • My issue is about the documentation content or website
Type of issue

I can't find what I'm looking for

Description

The page has the note
"This installation instruction refers to the 32-bit (armhf) version of Raspberry Pi OS."
(which is what most people will have if they buy a pre-installed SD card with their Pi)

But then continues down to a section with 4 installation options [ Desktop for linux , apt repo , manual , convenience script ] but most of these links seem to go off to generic pages, particularly the Desktop option (which I'm not even sure is a thing for a 32 bit Pi) goes to a page that says 64bit x86/amd is a requirement.

Also, the top alert box says "32-bit ARM (v7): Install the Debian armhf packages (targets ARMv7 CPUs).". This flummoxed me because it suggested I needed to do a specific thing with no link to that thing. Reading on I can see that "that thing" is in fact the very page I'm looking at - but it took a while for that to be clear.

Sorry if this all makes me seem quite dumb, but I'm a seasoned software professional who has (mis?) spent their career in DOS, so I'm having to learn linux, cope with the notoriously flakey Pi and learn a new technology all at once. I really could use a bit of spoon feeding from the actual "this is how to do stuff" pages.

Location

https://docs.docker.com/engine/install/raspberry-pi-os/

Suggestion

Reword as
"32-bit ARM (v7): Install the Debian armhf packages (targets ARMv7 CPUs). as described below on this page"

And remove the Docker Desktop option if it is true that it is not an option for Pi 32 (or clarify 64 bit only) or make a new page for Pi or explain that even though the page is takes you to says 64bit x86, it will still be fine on a Pi.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start with the Raspberry Pi OS installation page at docs.docker.com/engine/install/raspberry-pi-os/ and review the 32-bit alert, installation options, and Docker Desktop link. Confirm which options support 32-bit Raspberry Pi OS, then clarify the alert and remove or qualify the Desktop option so the page accurately guides users.

Written by the indexing model from the issue text.

Assessment

Tech stack
docker
Domain
documentation
Issue type
Documentation
Difficulty
2/5
Estimated time
1-3 hours
Activity status
Active
Clarity
Mostly clear
Newbie friendliness
72/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.