Add DebuggerDisableUserUnhandledExceptionsAttribute docs

Author: tommcdon

xml/System.Diagnostics/Debugger.xml

@@ -222,7 +222,13 @@ Console.WriteLine("Hello, world.");
         <summary>
           <para>Signals a breakpoint to an attached debugger with the <paramref name="exception" /> details if a .NET debugger is attached with break on user-unhandled exception enabled and a method attributed with DebuggerDisableUserUnhandledExceptionsAttribute calls this method.</para>
         </summary>
-        <remarks>To be added.</remarks>
+        <remarks>
+          <format type="text/markdown"><![CDATA[
+
+            ## Remarks
+            This API is designed to be used with <xref:System.Diagnostics.DebuggerDisableUserUnhandledExceptions>. 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 <paramref name="exception" />
+            ]]></format>
+        </remarks>
       </Docs>
     </Member>
     <Member MemberName="DefaultCategory">

xml/System.Diagnostics/DebuggerDisableUserUnhandledExceptionsAttribute.xml

@@ -23,7 +23,36 @@
     <summary>
       <para>If a .NET Debugger is attached which supports the Debugger.BreakForUserUnhandledException(Exception) API, this attribute will prevent the debugger from breaking on user-unhandled exceptions when the exception is caught by a method with this attribute, unless BreakForUserUnhandledException is called.</para>
     </summary>
-    <remarks>To be added.</remarks>
+    <remarks>
+      <format type="text/markdown"><![CDATA[
+
+        ## Remarks
+        Visual Studio has added support for catching asynchronous user-unhandled exceptions and is enabled by default. This feature has existed for a long time for synchronous methods, but not for async / await methods. The BreakForUserUnhandledException 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 <xref:System.Diagnostics.Debugger.BreakForUserUnhandledException>.
+
+        ## Example
+
+        ```csharp
+        [MethodImpl(MethodImplOptions.NoInlining)]
+        [DebuggerDisableUserUnhandledExceptions]
+        static async Task InvokeUserCode(Func<Task> 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.BreakForException(e); // debugger will stop here and show the exception if attached.
+          }
+        }
+        ```
+         ]]></format>
+    </remarks>
   </Docs>
   <Members>
     <Member MemberName=".ctor">