From 3884c166de70c591aede66cbdc085a4aabb209a1 Mon Sep 17 00:00:00 2001
From: "github-actions[bot]"
 <41898282+github-actions[bot]@users.noreply.github.com>
Date: Wed, 4 Mar 2026 13:59:55 +0000
Subject: [PATCH] docs: address issue #24270 (#24271)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

## Summary
Added timing expectations for diagnostics gathering to help users
understand the process may take several minutes.

## Changes
- Added NOTE callouts in three diagnostics sections explaining that
gathering diagnostics may take several minutes
- Advised users not to close Docker Desktop or terminal while
diagnostics are being collected
- Consistent messaging across "Diagnose from the app", "Diagnose from an
error message", and "Diagnose from the terminal" sections

Fixes #24270

---
🤖 Generated with [cagent](https://github.com/docker/cagent)

Co-authored-by: aevesdocker <102604716+aevesdocker@users.noreply.github.com>
---
 .../troubleshoot-and-support/troubleshoot/_index.md    | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/content/manuals/desktop/troubleshoot-and-support/troubleshoot/_index.md b/content/manuals/desktop/troubleshoot-and-support/troubleshoot/_index.md
index 422cc19dea..c93e7af2eb 100644
--- a/content/manuals/desktop/troubleshoot-and-support/troubleshoot/_index.md
+++ b/content/manuals/desktop/troubleshoot-and-support/troubleshoot/_index.md
@@ -53,6 +53,9 @@ If you are a Mac or Linux user, you also have the option to **Uninstall** Docker
 ### Diagnose from the app
 
 1. From **Troubleshoot**, select **Get support**. This opens the in-app Support page and starts collecting the diagnostics.
+   > [!NOTE]
+   >
+   > Gathering diagnostics may take several minutes. Don't close Docker Desktop while the diagnostics are being collected.
 2. When the diagnostics collection process is complete, select **Upload to get a Diagnostic ID**.
 3. When the diagnostics are uploaded, Docker Desktop prints a diagnostic ID. Copy this ID.
 4. Use your diagnostics ID to get help:
@@ -65,6 +68,9 @@ If you are a Mac or Linux user, you also have the option to **Uninstall** Docker
 ### Diagnose from an error message
 
 1. When an error message appears, select **Gather diagnostics**.
+   > [!NOTE]
+   >
+   > Gathering diagnostics may take several minutes. Don't close Docker Desktop while the diagnostics are being collected.
 2. When the diagnostics are uploaded, Docker Desktop prints a diagnostic ID. Copy this ID.
 3. Use your diagnostics ID to get help:
    - If you have a paid Docker subscription, select **Contact support**. This opens the Docker Desktop support form. Fill in the information required and add the ID you copied in step three to the **Diagnostics ID field**. Then, select **Submit ticket** to request Docker Desktop support.
@@ -78,6 +84,10 @@ If you are a Mac or Linux user, you also have the option to **Uninstall** Docker
 In some cases, it's useful to run the diagnostics yourself, for instance, if
 Docker Desktop cannot start.
 
+> [!NOTE]
+>
+> Gathering diagnostics may take several minutes. Wait for the process to complete before closing the terminal.
+
 {{< tabs group="os" >}}
 {{< tab name="Windows" >}}