diff --git a/xml/System.Diagnostics/Debugger.xml b/xml/System.Diagnostics/Debugger.xml
index e4310db60a1..bb3496c5b8b 100644
--- a/xml/System.Diagnostics/Debugger.xml
+++ b/xml/System.Diagnostics/Debugger.xml
@@ -218,9 +218,17 @@ Console.WriteLine("Hello, world.");
- To be added.
- To be added.
- To be added.
+ The user-unhandled exception.
+
+ Signals a breakpoint to an attached debugger with the details if a .NET debugger is attached with break on user-unhandled exception enabled and a method attributed with DebuggerDisableUserUnhandledExceptionsAttribute calls this method.
+
+
+ . If a .NET debugger is attached and the debugger supports breaking on user-unhandled exceptions, this method signals a breakpoint to the debugger with the `exception` parameter.
+ ]]>
+
diff --git a/xml/System.Diagnostics/DebuggerDisableUserUnhandledExceptionsAttribute.xml b/xml/System.Diagnostics/DebuggerDisableUserUnhandledExceptionsAttribute.xml
index 52574402d17..5f321f84b1d 100644
--- a/xml/System.Diagnostics/DebuggerDisableUserUnhandledExceptionsAttribute.xml
+++ b/xml/System.Diagnostics/DebuggerDisableUserUnhandledExceptionsAttribute.xml
@@ -20,8 +20,39 @@
- To be added.
- To be added.
+
+ If a .NET Debugger is attached that supports the API, the debugger won't break on user-unhandled exceptions when the exception is caught by a method with this attribute, unless is called.
+
+
+ method disables the feature for specific methods. This is useful for exceptions that propagate through user code but are expected to be handled by framework code. This attribute is designed to be used along with .
+
+ ## Example
+
+ ```csharp
+ [MethodImpl(MethodImplOptions.NoInlining)]
+ [DebuggerDisableUserUnhandledExceptions]
+ static async Task InvokeUserCode(Func userCode)
+ {
+ try
+ {
+ await userCode();
+ }
+ catch (Exception ex)
+ {
+ if (TryHandleWithFilter(ex))
+ {
+ return; // example case where we don't want to break for user-unhandled exceptions
+ }
+
+ Debugger.BreakForUserUnhandledException(e); // debugger will stop here and show the exception if attached.
+ }
+ }
+ ```
+ ]]>
+