From 4afb0e53b5646edfbb8dee5926204dbffd70a236 Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Tue, 21 Oct 2025 16:35:25 +0000
Subject: [PATCH] Add XML documentation to InvokeLeakTest about debugger issues

Co-authored-by: tig <585482+tig@users.noreply.github.com>
---
 Tests/StressTests/ApplicationStressTests.cs | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

diff --git a/Tests/StressTests/ApplicationStressTests.cs b/Tests/StressTests/ApplicationStressTests.cs
index 314461457..943ff37e0 100644
--- a/Tests/StressTests/ApplicationStressTests.cs
+++ b/Tests/StressTests/ApplicationStressTests.cs
@@ -19,6 +19,23 @@ public class ApplicationStressTests : TestsAllViews
     private const int NUM_INCREMENTS = 500;
     private const int POLL_MS = 100;
 
+    /// <summary>
+    /// Stress test for Application.Invoke to verify that invocations from background threads
+    /// are not lost or delayed indefinitely. Tests 25,000 concurrent invocations (50 passes × 500 increments).
+    /// </summary>
+    /// <remarks>
+    /// <para>
+    /// NOTE: This test may fail when run under a debugger due to timing issues related to 
+    /// DateTime.UtcNow resolution and debugger overhead. See InvokeLeakTest_Analysis.md for details.
+    /// </para>
+    /// <para>
+    /// If this test fails under debugger:
+    /// - It is likely a timing issue, not a functional bug
+    /// - Try running without debugger to verify
+    /// - Consider increasing POLL_MS if debugging is required
+    /// - See issue #4296 for detailed analysis
+    /// </para>
+    /// </remarks>
     [Theory]
     [InlineData (typeof (FakeDriver))]
     //[InlineData (typeof (DotNetDriver), Skip = "System.IO.IOException: The handle is invalid")]