diff --git a/src/frontend/src/content/docs/reference/cli/commands/aspire-stop.mdx b/src/frontend/src/content/docs/reference/cli/commands/aspire-stop.mdx
index bcca26551..4a068f41a 100644
--- a/src/frontend/src/content/docs/reference/cli/commands/aspire-stop.mdx
+++ b/src/frontend/src/content/docs/reference/cli/commands/aspire-stop.mdx
@@ -29,6 +29,10 @@ When executed without the `--apphost` option, the command:
 
 The command sends a stop signal to the CLI process that started the AppHost, which ensures a clean shutdown of all resources including the dashboard and any containers or processes that were started.
 
+### Stopping a detached AppHost
+
+When stopping an AppHost that was started with [`aspire run --detach`](/reference/cli/commands/aspire-run/#options), the `aspire stop` command waits for the AppHost process to terminate and then removes the backchannel socket file it previously used for communication. Cleaning up the socket file ensures that subsequent CLI commands such as `aspire add` or `aspire describe` do not encounter stale-connection errors from a dead AppHost process.
+
 ## Options
 
 The following options are available: