cleanup and add link to conceptual doc (dotnet#8845)

Author: gewarren

xml/System.Runtime.ExceptionServices/ExceptionDispatchInfo.xml

@@ -44,12 +44,16 @@
       <format type="text/markdown"><![CDATA[  
   
 ## Remarks  
- The <xref:System.Runtime.ExceptionServices.ExceptionDispatchInfo> object stores the stack trace information and Watson information that the exception contains at the point where it is captured. The exception can be thrown at another time and possibly on another thread by calling the <xref:System.Runtime.ExceptionServices.ExceptionDispatchInfo.Throw%2A?displayProperty=nameWithType> method. The exception is thrown as if it had flowed from the point where it was captured to the point where the <xref:System.Runtime.ExceptionServices.ExceptionDispatchInfo.Throw%2A> method is called.  
-  
- <xref:System.Runtime.ExceptionServices.ExceptionDispatchInfo> cannot be serialized and is not intended to cross application domain boundaries.  
-  
+
+An <xref:System.Runtime.ExceptionServices.ExceptionDispatchInfo> object stores the stack trace information and Watson information that an exception contains at the point where it's captured. The exception can then be thrown at another time and possibly on another thread by calling the <xref:System.Runtime.ExceptionServices.ExceptionDispatchInfo.Throw%2A?displayProperty=nameWithType> method. The exception is thrown as if it had flowed from the point where it was captured to the point where the <xref:System.Runtime.ExceptionServices.ExceptionDispatchInfo.Throw%2A> method is called.
+
+For an example, see [Capture exceptions to rethrow later](/dotnet/standard/exceptions/best-practices-for-exceptions#capture-exceptions-to-rethrow-later).
+
+<xref:System.Runtime.ExceptionServices.ExceptionDispatchInfo> cannot be serialized and is not intended to cross application domain boundaries.
+
  ]]></format>
     </remarks>
+    <related type="Article" href="/dotnet/standard/exceptions/best-practices-for-exceptions#capture-exceptions-to-rethrow-later">Capture exceptions to rethrow later</related>
   </Docs>
   <Members>
     <Member MemberName="Capture">
@@ -97,14 +101,15 @@
           <format type="text/markdown"><![CDATA[  
   
 ## Remarks  
- You can use the <xref:System.Runtime.ExceptionServices.ExceptionDispatchInfo> object that is returned by this method at another time and possibly on another thread to rethrow the specified exception, as if the exception had flowed from this point where it was captured to the point where it is rethrown.  
+ You can use the <xref:System.Runtime.ExceptionServices.ExceptionDispatchInfo> object that's returned by this method at another time and possibly on another thread to rethrow the specified exception, as if the exception had flowed from the point where it was captured to the point where it's rethrown.  
   
- If the exception is active when it is captured, the current stack trace information and Watson information that is contained in the exception is stored.  If it is inactive, that is, if it has not been thrown, it will not have any stack trace information or Watson information.  
+ If the exception is active when it's captured, the current stack trace information and Watson information that's contained in the exception is stored. If it's inactive, that is, if it has not been thrown, it doesn't have any stack trace or Watson information.  
   
  ]]></format>
         </remarks>
         <exception cref="T:System.ArgumentException">
           <paramref name="source" /> is <see langword="null" />.</exception>
+        <related type="Article" href="/dotnet/standard/exceptions/best-practices-for-exceptions#capture-exceptions-to-rethrow-later">Capture exceptions to rethrow later</related>
       </Docs>
     </Member>
     <Member MemberName="SetCurrentStackTrace">
@@ -169,27 +174,20 @@
         <Parameter Name="stackTrace" Type="System.String" Index="1" FrameworkAlternate="net-6.0;net-7.0" />
       </Parameters>
       <Docs>
-        <param name="source">The unthrown <see cref="T:System.Exception" /> instance.</param>
-        <param name="stackTrace">The stack trace string to persist within <paramref name="source" />. This is normally acquired from the <see cref="P:System.Exception.StackTrace" /> property from the remote exception instance.</param>
+        <param name="source">The unthrown exception.</param>
+        <param name="stackTrace">The stack trace string to persist within <paramref name="source" />. This is normally acquired from the <see cref="P:System.Exception.StackTrace" /> property of the remote exception instance.</param>
         <summary>Stores the provided stack trace into the specified <see cref="T:System.Exception" /> instance.</summary>
         <returns>The <paramref name="source" /> exception instance.</returns>
         <remarks>
           <format type="text/markdown"><![CDATA[
 
 ## Remarks
 
-This method populates the <xref:System.Exception.StackTrace> property from an arbitrary string value.
-             The typical use case is the transmission of <xref:System.Exception> objects across processes with high fidelity,
-             allowing preservation of the exception object's stack trace information. .NET does not attempt to parse the
-             provided string value.
+This method populates the <xref:System.Exception.StackTrace> property from an arbitrary string value. The typical use case is the transmission of <xref:System.Exception> objects across processes with high fidelity, allowing preservation of the exception object's stack trace information. .NET does not attempt to parse the provided string value.
             
-The caller is responsible for canonicalizing line endings if required. <xref:System.String.ReplaceLineEndings>
-             can be used to canonicalize line endings.
+The caller is responsible for canonicalizing line endings if required. <xref:System.String.ReplaceLineEndings> can be used to canonicalize line endings.
 
-If the caller provides untrusted input to this API, this may result in the exception's stack trace containing
-             embedded null characters, reserved HTML or JSON characters, or other unexpected values. Applications that
-             display an exception's details to the user should always take care to encode the exception information at the
-             point where it is displayed.
+If the caller provides untrusted input to this API, this may result in the exception's stack trace containing embedded null characters, reserved HTML or JSON characters, or other unexpected values. Applications that display an exception's details to the user should always take care to encode the exception information at the point where it's displayed.
 
           ]]></format>
         </remarks>
@@ -232,13 +230,13 @@ If the caller provides untrusted input to this API, this may result in the excep
         <ReturnType>System.Exception</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>Gets the exception that is represented by the current instance.</summary>
-        <value>The exception that is represented by the current instance.</value>
+        <summary>Gets the exception that's represented by the current instance.</summary>
+        <value>The exception that's represented by the current instance.</value>
         <remarks>
           <format type="text/markdown"><![CDATA[  
   
 ## Remarks  
- This property is used by the Task Parallel Library, for example, to combine multiple exceptions in an <xref:System.AggregateException> object. It is not intended to be used by application code. Use the <xref:System.Runtime.ExceptionServices.ExceptionDispatchInfo.Throw%2A> method to restore the state of the captured exception and throw it.  
+ This property is used by the Task Parallel Library, for example, to combine multiple exceptions in an <xref:System.AggregateException> object. It's not intended to be used by application code. Use the <xref:System.Runtime.ExceptionServices.ExceptionDispatchInfo.Throw%2A> method to restore the state of the captured exception and throw it.  
   
  ]]></format>
         </remarks>
@@ -286,12 +284,12 @@ If the caller provides untrusted input to this API, this may result in the excep
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>Throws the exception that is represented by the current <see cref="T:System.Runtime.ExceptionServices.ExceptionDispatchInfo" /> object, after restoring the state that was saved when the exception was captured.</summary>
+        <summary>Throws the exception that's represented by the current <see cref="T:System.Runtime.ExceptionServices.ExceptionDispatchInfo" /> object, after restoring the state that was saved when the exception was captured.</summary>
         <remarks>
           <format type="text/markdown"><![CDATA[  
   
 ## Remarks  
- When the exception is restored, the following string is inserted in the stack trace to indicate the restore point: "End of stack trace from the previous location where the exception was thrown". This is similar to the way inner exceptions or marshaled exceptions are indicated in stack traces.  
+ When the exception is restored, the following string is inserted in the stack trace to indicate the restore point: `"End of stack trace from the previous location where the exception was thrown"`. This is similar to the way inner exceptions or marshaled exceptions are indicated in stack traces.  
   
  ]]></format>
         </remarks>