From 105cba6a1cec7f42c7b9b80ec59216fca5834af3 Mon Sep 17 00:00:00 2001
From: AI-scor <354880559+AI-scor@users.noreply.github.com>
Date: Tue, 10 Nov 2026 20:38:41 +0100
Subject: [PATCH] [Docs] Document TappedOutInterface::analyzeDeck lifecycle
 (#7887)

---
 .../src/client/network/interfaces/tapped_out_interface.h    | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/cockatrice/src/client/network/interfaces/tapped_out_interface.h b/cockatrice/src/client/network/interfaces/tapped_out_interface.h
index 27e8c2273..c8d7577e2 100644
--- a/cockatrice/src/client/network/interfaces/tapped_out_interface.h
+++ b/cockatrice/src/client/network/interfaces/tapped_out_interface.h
@@ -40,6 +40,12 @@ private slots:
 
 public:
     explicit TappedOutInterface(QObject *parent = nullptr);
+    /**
+     * Posts the deck for analysis and returns immediately; there is no signal for the
+     * outcome. The result opens in the browser or an error dialog, after which the
+     * interface deletes itself, so a caller must call this once and not keep or reuse
+     * the pointer afterwards.
+     */
     void analyzeDeck(const DeckList &deck);
 };