docs icon indicating copy to clipboard operation
docs copied to clipboard

The docs for ubuntu desktop for linux has poor ux in several ways.

Open Johnrobmiller opened this issue 1 year ago • 1 comments

Is this a docs issue?

  • [X] My issue is about the documentation content or website

Type of issue

There's a problem with the website

Description

Hi, I'm noticing a few usability issues with the docs, and I thought I might try and help you guys out by doing a bit of QA for you guys and bringing awareness to these issues.

Firstly, the "DEB package" button is not prominent enough on the screen. Real users don't read the docs line by line and carefully examine the elements on the screen. So this important button is going to be needlessly missed, and at a high rate. Whoever is designing this page needs to do some touch up work to make this much clearer.

Second, on the docs for docker desktop for linux, you instruct the user to install via the following command:

sudo apt-get update
sudo apt-get install ./docker-desktop-<version>-<arch>.deb

However, there is a problem. Instead of requiring the user to go on a hunt to find the latest version number, you should just tell them. To not do so is lazy and bad ux. I'm sure there is a way to fetch the version number from github and display it on the page.

Third, you should also explain what <arch> means for newcomers to linux.

There might be more issues, but theses are some that I noticed while using them to install docker desktop on linux.

Location

https://docs.docker.com/desktop/install/ubuntu/

Suggestion

No response

Johnrobmiller avatar Apr 02 '24 02:04 Johnrobmiller

There hasn't been any activity on this issue for a long time. If the problem is still relevant, mark the issue as fresh with a /remove-lifecycle stale comment. If not, this issue will be closed in 14 days. This helps our maintainers focus on the active issues.

Prevent issues from auto-closing with a /lifecycle frozen comment.

/lifecycle stale

docker-robot[bot] avatar Jul 01 '24 01:07 docker-robot[bot]

Closed issues are locked after 30 days of inactivity. This helps our team focus on active issues.

If you have found a problem that seems similar to this, please open a new issue.

/lifecycle locked

docker-robot[bot] avatar Aug 14 '24 03:08 docker-robot[bot]