Fix xmldoc

Author: angularsen

src/Serilog.Extensions.Hosting/Extensions/Hosting/DiagnosticContextCollector.cs

@@ -68,6 +68,7 @@ public void SetException(Exception exception)
         /// </summary>
         /// <param name="properties">The collected properties, or null if no collection is active.</param>
         /// <returns>True if properties could be collected.</returns>
+        /// <seealso cref="IDiagnosticContext.Set"/>
         public bool TryComplete(out IEnumerable<LogEventProperty> properties)
         {
             lock (_propertiesLock)
@@ -81,21 +82,15 @@ public bool TryComplete(out IEnumerable<LogEventProperty> properties)
         }
 
         /// <summary>
-        /// Complete the context and retrieve the properties added to it, if any. This will
+        /// Complete the context and retrieve the properties and exception added to it, if any. This will
         /// stop collection and remove the collector from the original execution context and
         /// any of its children.
         /// </summary>
         /// <param name="properties">The collected properties, or null if no collection is active.</param>
         /// <param name="exception">The collected exception, or null if none has been collected or if no collection is active.</param>
         /// <returns>True if properties could be collected.</returns>
-        /// <example>
-        /// This overload provides the exception collected by the diagnostic context, which is useful when unhandled exceptions are handled
-        /// before reaching Serilog's RequestLoggingMiddleware. One example is using https://www.nuget.org/packages/Hellang.Middleware.ProblemDetails to transform
-        /// exceptions to ProblemDetails responses.
-        /// </example>
-        /// <remarks>
-        /// If an unhandled exception reaches Serilog's RequestLoggingMiddleware, then the unhandled exception should take precedence.<br/>
-        /// </remarks>
+        /// <seealso cref="IDiagnosticContext.Set"/>
+        /// <seealso cref="Serilog.IDiagnosticContext.SetException"/>
         public bool TryComplete(out IEnumerable<LogEventProperty> properties, out Exception exception)
         {
             lock (_propertiesLock)

src/Serilog.Extensions.Hosting/IDiagnosticContext.cs

@@ -32,15 +32,13 @@ public interface IDiagnosticContext
         void Set(string propertyName, object value, bool destructureObjects = false);
 
         /// <summary>
-        /// Set an exception to include in the Serilog request log event.
+        /// Set the specified exception on the current diagnostic context.
+        /// <br/><br/>
+        /// This is useful when unhandled exceptions do not reach Serilog.AspNetCore's RequestLoggingMiddleware,
+        /// such as when using <a href="https://www.nuget.org/packages/Hellang.Middleware.ProblemDetails">Hellang.Middleware.ProblemDetails</a>
+        /// to transform exceptions to ProblemDetails responses.
         /// </summary>
-        /// <example>
-        /// Passing an exception to the diagnostic context is useful when unhandled exceptions are handled before reaching Serilog's
-        /// RequestLoggingMiddleware. One example is using https://www.nuget.org/packages/Hellang.Middleware.ProblemDetails to transform
-        /// exceptions to ProblemDetails responses.
-        /// </example>
         /// <remarks>
-        /// If an unhandled exception reaches Serilog's RequestLoggingMiddleware, then the unhandled exception takes precedence.<br/>
         /// If <c>null</c> is given, it clears any previously assigned exception.
         /// </remarks>
         /// <param name="exception">The exception to log.</param>