Skip to content

Conversation

@p1-0tr
Copy link

@p1-0tr p1-0tr commented Jul 29, 2022

Proposed changes

Currently it's easy for users to skip the per-distro installation steps,
since direct download links for our packages are presented first. This
can lead to unnecessary frustration, since DD will not install if
pre-requisite steps are not followed. So instead of presenting package
download links in the most prominent spot, point users to per-distro
installation instructions.

Related issues (optional)

@netlify
Copy link

netlify bot commented Jul 29, 2022

Deploy Preview for docsdocker ready!

Built without sensitive environment variables

Name Link
🔨 Latest commit d5b6122
🔍 Latest deploy log https://app.netlify.com/sites/docsdocker/deploys/62e3c170d36f280008dcb7b9
😎 Deploy Preview https://deploy-preview-15259--docsdocker.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify site settings.

@aevesdocker
Copy link
Contributor

Thanks for PR @p1-0tr. Can we add the download packages (as a button) to the Ubuntu, Fedora and Debian pages, so users don't have to navigate to the release notes to install.

Also, I'm not sure about displaying the links to the pages as buttons. I think it would be better to do something like:

'Follow the links below to view the distro-specific installation instructions:

We could still wrap it in a note to make it pop out from the text.

@p1-0tr p1-0tr force-pushed the ps-dd4l-improve-install-instructions branch from 8c8f3ba to 05f2a1d Compare July 29, 2022 10:53
1. Set up [Docker's package repository](../../engine/install/debian.md#set-up-the-repository).

2. Download latest DEB package from the [release](../release-notes.md) page.
2. Download latest DEB package:
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Sorry @p1-0tr , that was a bad idea of mine - this doesn't look great. Let's just keep it as it was with the links

Copy link
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Done :) I made them direct download links, but inline

This page contains information about system requirements, download URLs, and instructions on how to install and update Docker Desktop for Linux.

> Download Docker Desktop for Linux packages
> Follow the links below to view the distro-specific installation instructions:
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yes, this looks better, thank you

Currently it's easy for users to skip the per-distro installation steps,
since direct download links for our packages are presented first. This
can lead to unnecessary frustration, since DD will not install if
pre-requisite steps are not followed. So instead of presenting package
download links in the most prominent spot, point users to per-distro
installation instructions.

Signed-off-by: Piotr Stankiewicz <piotr.stankiewicz@docker.com>
@p1-0tr p1-0tr force-pushed the ps-dd4l-improve-install-instructions branch from 05f2a1d to d5b6122 Compare July 29, 2022 11:15
Copy link
Contributor

@aevesdocker aevesdocker left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thank you @p1-0tr!

@aevesdocker aevesdocker enabled auto-merge July 29, 2022 11:18
@aevesdocker aevesdocker merged commit fd291f5 into docker:master Jul 29, 2022
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants