engine: simplify apt-based installation for debian

Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>

content/compose/install/linux.md

@@ -31,7 +31,7 @@ For Compose standalone, see [Install Compose Standalone](standalone.md).
 
     [Ubuntu](../../engine/install/ubuntu.md/#set-up-the-repository) |
     [CentOS](../../engine/install/centos.md/#set-up-the-repository) |
-    [Debian](../../engine/install/debian.md/#set-up-the-repository) |
+    [Debian](../../engine/install/debian.md/#install-using-the-repository) |
     [Fedora](../../engine/install/fedora.md/#set-up-the-repository) |
     [RHEL](../../engine/install/rhel.md/#set-up-the-repository) |
     [SLES](../../engine/install/sles.md/#set-up-the-repository).

content/desktop/install/debian.md

@@ -50,7 +50,8 @@ To install Docker Desktop successfully, you must:
 
 Recommended approach to install Docker Desktop on Debian:
 
-1. Set up [Docker's package repository](../../engine/install/debian.md#set-up-the-repository).
+1. Set up Docker's Apt repository.
+   See [Install using the Apt repository, step 1](../../engine/install/debian.md#install-using-the-repository).
 
 2. Download latest [DEB package](https://desktop.docker.com/linux/main/amd64/docker-desktop-4.22.1-amd64.deb?utm_source=docker&utm_medium=webreferral&utm_campaign=docs-driven-download-linux-amd64).
 

content/engine/install/debian.md

@@ -78,45 +78,35 @@ You can install Docker Engine in different ways, depending on your needs:
   the easiest and quickest way to get started.
 
 - Set up and install Docker Engine from
-  [Docker's `apt` repository](#install-using-the-repository).
+  [Docker's Apt repository](#install-using-the-repository).
 
 - [Install it manually](#install-from-a-package) and manage upgrades manually.
 
 - Use a [convenience scripts](#install-using-the-convenience-script). Only
   recommended for testing and development environments.
 
-### Install using the apt repository {#install-using-the-repository}
+### Install using the Apt repository {#install-using-the-repository}
 
 Before you install Docker Engine for the first time on a new host machine, you
-need to set up the Docker repository. Afterward, you can install and update
+need to set up the Docker Apt repository. Afterward, you can install and update
 Docker from the repository.
 
-#### Set up the repository
+1. Set up Docker's Apt repository.
 
+   ```bash
+   # Add Docker's official GPG key:
+   sudo apt-get update
+   sudo apt-get install ca-certificates curl gnupg
+   sudo install -m 0755 -d /etc/apt/keyrings
+   curl -fsSL {{% param "download-url-base" %}}/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
+   sudo chmod a+r /etc/apt/keyrings/docker.gpg
 
-1.  Update the `apt` package index and install packages to allow `apt` to use a
-    repository over HTTPS:
-
-    ```console
-    $ sudo apt-get update
-    $ sudo apt-get install ca-certificates curl gnupg
-    ```
-
-2.  Add Docker's official GPG key:
-
-    ```console
-    $ sudo install -m 0755 -d /etc/apt/keyrings
-    $ curl -fsSL {{% param "download-url-base" %}}/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
-    $ sudo chmod a+r /etc/apt/keyrings/docker.gpg
-    ```
-
-3.  Use the following command to set up the repository:
-
-    ```console
-    $ echo \
+   # Add the repository to Apt sources:
+   echo \
      "deb [arch="$(dpkg --print-architecture)" signed-by=/etc/apt/keyrings/docker.gpg] {{% param "download-url-base" %}} \
      "$(. /etc/os-release && echo "$VERSION_CODENAME")" stable" | \
      sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
+   sudo apt-get update
    ```
 
    > **Note**
@@ -129,15 +119,7 @@ Docker from the repository.
    > $(. /etc/os-release && echo "$VERSION_CODENAME")
    > ```
 
-4. Update the `apt` package index:
-
-   ```console
-   $ sudo apt-get update
-   ```
-
-#### Install Docker Engine
-
-1. Install Docker Engine, containerd, and Docker Compose.
+2. Install the Docker packages.
 
    {{< tabs >}}
    {{< tab name="Latest" >}}
@@ -151,8 +133,8 @@ Docker from the repository.
    {{< /tab >}}
    {{< tab name="Specific version" >}}
 
-   To install a specific version of Docker Engine, start by listing the available
-   versions in the repository:
+   To install a specific version of Docker Engine, start by listing the
+   available versions in the repository:
 
    ```console
    # List the available versions:
@@ -160,7 +142,7 @@ Docker from the repository.
 
    5:24.0.0-1~debian.11~bullseye
    5:23.0.6-1~debian.11~bullseye
-   <...>
+   ...
    ```
 
    Select the desired version and install:
@@ -173,8 +155,8 @@ Docker from the repository.
    {{< /tab >}}
    {{< /tabs >}}
 
-2. Verify that the Docker Engine installation is successful by running the
-   `hello-world` image:
+3. Verify that the installation is successful by running the `hello-world`
+   image:
 
    ```console
    $ sudo docker run hello-world
@@ -189,9 +171,9 @@ You have now successfully installed and started Docker Engine.
 
 #### Upgrade Docker Engine
 
-To upgrade Docker Engine, follow the
-[installation instructions](#install-docker-engine), choosing the new version
-you want to install.
+To upgrade Docker Engine, follow step 2 of the
+[installation instructions](#install-using-the-repository),
+choosing the new version you want to install.
 
 ### Install from a package