From 3eeea781daf3bcf22de3df8f7bf4faf1ea583652 Mon Sep 17 00:00:00 2001
From: Allie Sadler <102604716+aevesdocker@users.noreply.github.com>
Date: Tue, 13 Jun 2023 09:48:03 +0100
Subject: [PATCH] symlink clarification (#17530)

* symlink clarification

* grammar

* wording tweak

* wording tweak
---
 _includes/desktop-linux-launch.md | 4 ++--
 desktop/install/debian.md         | 3 ++-
 desktop/install/fedora.md         | 3 ++-
 desktop/install/ubuntu.md         | 3 ++-
 4 files changed, 8 insertions(+), 5 deletions(-)

diff --git a/_includes/desktop-linux-launch.md b/_includes/desktop-linux-launch.md
index 5fa12c1c01..292d36beb7 100644
--- a/_includes/desktop-linux-launch.md
+++ b/_includes/desktop-linux-launch.md
@@ -19,8 +19,8 @@ context to the previous one.
 The Docker Desktop installer updates Docker Compose and the Docker CLI binaries
 on the host. It installs Docker Compose V2 and gives users the choice to
 link it as docker-compose from the Settings panel. Docker Desktop installs
-the new Docker CLI binary that includes cloud-integration capabilities in `/usr/local/bin`
-and creates a symlink to the classic Docker CLI at `/usr/local/bin/com.docker.cli`.
+the new Docker CLI binary that includes cloud-integration capabilities in `/usr/local/bin/com.docker.cli`
+and creates a symlink to the classic Docker CLI at `/usr/local/bin`.
 
 After you’ve successfully installed Docker Desktop, you can check the versions
 of these binaries by running the following commands:
diff --git a/desktop/install/debian.md b/desktop/install/debian.md
index 8fcca7939c..edf2b667eb 100644
--- a/desktop/install/debian.md
+++ b/desktop/install/debian.md
@@ -76,7 +76,8 @@ The post-install script:
 
 - Sets the capability on the Docker Desktop binary to map privileged ports and set resource limits.
 - Adds a DNS name for Kubernetes to `/etc/hosts`.
-- Creates a link from `/usr/bin/docker` to `/usr/local/bin/com.docker.cli`.
+- Creates a symlink from `/usr/local/bin/com.docker.cli` to `/usr/bin/docker`.
+  This is because the classic Docker CLI is installed at `/usr/bin/docker`. The Docker Desktop installer also installs a Docker CLI binary that includes cloud-integration capabilities and is essentially a wrapper for the Compose CLI, at`/usr/local/bin/com.docker.cli`. The symlink ensures that the wrapper can access the classic Docker CLI. 
 
 ## Launch Docker Desktop
 
diff --git a/desktop/install/fedora.md b/desktop/install/fedora.md
index 068a8b0e89..91d084c0c1 100644
--- a/desktop/install/fedora.md
+++ b/desktop/install/fedora.md
@@ -46,7 +46,8 @@ The post-install script:
 
 - Sets the capability on the Docker Desktop binary to map privileged ports and set resource limits.
 - Adds a DNS name for Kubernetes to `/etc/hosts`.
-- Creates a link from `/usr/bin/docker` to `/usr/local/bin/com.docker.cli`.
+- Creates a symlink from `/usr/local/bin/com.docker.cli` to `/usr/bin/docker`.
+  This is because the classic Docker CLI is installed at `/usr/bin/docker`. The Docker Desktop installer also installs a Docker CLI binary that includes cloud-integration capabilities and is essentially a wrapper for the Compose CLI, at`/usr/local/bin/com.docker.cli`. The symlink ensures that the wrapper can access the classic Docker CLI. 
 
 ## Launch Docker Desktop
 
diff --git a/desktop/install/ubuntu.md b/desktop/install/ubuntu.md
index a482987bda..164747ac9d 100644
--- a/desktop/install/ubuntu.md
+++ b/desktop/install/ubuntu.md
@@ -72,7 +72,8 @@ The post-install script:
 
 - Sets the capability on the Docker Desktop binary to map privileged ports and set resource limits.
 - Adds a DNS name for Kubernetes to `/etc/hosts`.
-- Creates a link from `/usr/bin/docker` to `/usr/local/bin/com.docker.cli`.
+- Creates a symlink from `/usr/local/bin/com.docker.cli` to `/usr/bin/docker`.
+  This is because the classic Docker CLI is installed at `/usr/bin/docker`. The Docker Desktop installer also installs a Docker CLI binary that includes cloud-integration capabilities and is essentially a wrapper for the Compose CLI, at`/usr/local/bin/com.docker.cli`. The symlink ensures that the wrapper can access the classic Docker CLI. 
 
 ## Launch Docker Desktop