From a68d7b0749551ab8296fa430a435e886fa0bae83 Mon Sep 17 00:00:00 2001
From: Allie Sadler <102604716+aevesdocker@users.noreply.github.com>
Date: Wed, 22 Jan 2025 21:29:05 +0000
Subject: [PATCH] ENGDOCS-2388 (#21868)

<!--Delete sections as needed -->

## Description

Quick docs fix for a common reason why users may see that error.
(Am aware the rest of the page could do with some attention, but it's
gotta wait its turn).

## Related issues or tickets

<!-- Related issues, pull requests, or Jira tickets -->

## Reviews

<!-- Notes for reviewers here -->
<!-- List applicable reviews (optionally @tag reviewers) -->

- [ ] Technical review
- [ ] Editorial review
- [ ] Product review
---
 .../troubleshoot/_index.md                    | 20 +++++++++----------
 .../troubleshoot/topics.md                    |  6 +++++-
 2 files changed, 15 insertions(+), 11 deletions(-)

diff --git a/content/manuals/desktop/troubleshoot-and-support/troubleshoot/_index.md b/content/manuals/desktop/troubleshoot-and-support/troubleshoot/_index.md
index 90d5481efc..8e127ce261 100644
--- a/content/manuals/desktop/troubleshoot-and-support/troubleshoot/_index.md
+++ b/content/manuals/desktop/troubleshoot-and-support/troubleshoot/_index.md
@@ -6,16 +6,16 @@ toc_max: 2
 title: Troubleshoot Docker Desktop
 linkTitle: Troubleshoot and diagnose
 aliases:
-- /desktop/linux/troubleshoot/
-- /desktop/mac/troubleshoot/
-- /desktop/windows/troubleshoot/
-- /docker-for-mac/troubleshoot/
-- /mackit/troubleshoot/
-- /windows/troubleshoot/
-- /docker-for-win/troubleshoot/
-- /docker-for-windows/troubleshoot/
-- /desktop/troubleshoot/overview/
-- /desktop/troubleshoot/
+ - /desktop/linux/troubleshoot/
+ - /desktop/mac/troubleshoot/
+ - /desktop/windows/troubleshoot/
+ - /docker-for-mac/troubleshoot/
+ - /mackit/troubleshoot/
+ - /windows/troubleshoot/
+ - /docker-for-win/troubleshoot/
+ - /docker-for-windows/troubleshoot/
+  - /desktop/troubleshoot/overview/
+ - /desktop/troubleshoot/
 tags: [ Troubleshooting ]
 weight: 10
 ---
diff --git a/content/manuals/desktop/troubleshoot-and-support/troubleshoot/topics.md b/content/manuals/desktop/troubleshoot-and-support/troubleshoot/topics.md
index f43344eca3..b4ba08920d 100644
--- a/content/manuals/desktop/troubleshoot-and-support/troubleshoot/topics.md
+++ b/content/manuals/desktop/troubleshoot-and-support/troubleshoot/topics.md
@@ -84,10 +84,14 @@ Following are the examples of errors on MacOS which indicate that the startup fa
 
 ### Incompatible CPU detected
 
+> [!TIP]
+>
+> If you are seeing this error, check you've installed the correct Docker Desktop for your architecture. 
+
 Docker Desktop requires a processor (CPU) that supports virtualization and, more
 specifically, the [Apple Hypervisor
 framework](https://developer.apple.com/library/mac/documentation/DriversKernelHardware/Reference/Hypervisor/).
-Docker Desktop is only compatible with Mac systems that have a CPU that supports the Hypervisor framework. Most Macs built in 2010 and later support it,as described in the Apple Hypervisor Framework documentation about supported hardware:
+Docker Desktop is only compatible with Mac systems that have a CPU that supports the Hypervisor framework. Most Macs built in 2010 and later support it, as described in the Apple Hypervisor Framework documentation about supported hardware:
 
 *Generally, machines with an Intel VT-x feature set that includes Extended Page
 Tables (EPT) and Unrestricted Mode are supported.*