From ed13070174851316fe5c2b9f8c71e8c29e9af1f8 Mon Sep 17 00:00:00 2001
From: Genevieve Warren <24882762+gewarren@users.noreply.github.com>
Date: Mon, 8 Nov 2021 16:09:02 -0800
Subject: [PATCH] Add exception (#7360)

---
 .../LoggerFactory.xml                         | 20 ++++++++++---------
 1 file changed, 11 insertions(+), 9 deletions(-)

diff --git a/xml/Microsoft.Extensions.Logging/LoggerFactory.xml b/xml/Microsoft.Extensions.Logging/LoggerFactory.xml
index a5fed06dfe6..c493af3c878 100644
--- a/xml/Microsoft.Extensions.Logging/LoggerFactory.xml
+++ b/xml/Microsoft.Extensions.Logging/LoggerFactory.xml
@@ -29,7 +29,7 @@
     </Interface>
   </Interfaces>
   <Docs>
-    <summary>Produces instances of <see cref="T:Microsoft.Extensions.Logging.ILogger" /> classes based on the given providers.</summary>
+    <summary>Produces instances of <see cref="T:Microsoft.Extensions.Logging.ILogger" /> classes based on the specified providers.</summary>
     <remarks>To be added.</remarks>
   </Docs>
   <Members>
@@ -81,7 +81,7 @@
       </Parameters>
       <Docs>
         <param name="providers">The providers to use in producing <see cref="T:Microsoft.Extensions.Logging.ILogger" /> instances.</param>
-        <summary>Creates a new <see cref="T:Microsoft.Extensions.Logging.LoggerFactory" /> instance.</summary>
+        <summary>Creates a new <see cref="T:Microsoft.Extensions.Logging.LoggerFactory" /> instance with the specified providers.</summary>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -110,7 +110,7 @@
       <Docs>
         <param name="providers">The providers to use in producing <see cref="T:Microsoft.Extensions.Logging.ILogger" /> instances.</param>
         <param name="filterOptions">The filter options to use.</param>
-        <summary>Creates a new <see cref="T:Microsoft.Extensions.Logging.LoggerFactory" /> instance.</summary>
+        <summary>Creates a new <see cref="T:Microsoft.Extensions.Logging.LoggerFactory" /> instance with the specified providers and filter options.</summary>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -139,7 +139,7 @@
       <Docs>
         <param name="providers">The providers to use in producing <see cref="T:Microsoft.Extensions.Logging.ILogger" /> instances.</param>
         <param name="filterOption">The filter option to use.</param>
-        <summary>Creates a new <see cref="T:Microsoft.Extensions.Logging.LoggerFactory" /> instance.</summary>
+        <summary>Creates a new <see cref="T:Microsoft.Extensions.Logging.LoggerFactory" /> instance with the specified providers and filter option.</summary>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -164,7 +164,7 @@
         <param name="providers">The providers to use in producing <see cref="T:Microsoft.Extensions.Logging.ILogger" /> instances.</param>
         <param name="filterOption">The filter option to use.</param>
         <param name="options">The logger factory options.</param>
-        <summary>Creates a new <see cref="T:Microsoft.Extensions.Logging.LoggerFactory" /> instance with the specified providers, filter option and logger factory options.</summary>
+        <summary>Creates a new <see cref="T:Microsoft.Extensions.Logging.LoggerFactory" /> instance with the specified providers, filter option, and logger factory options.</summary>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -199,8 +199,10 @@
       </Parameters>
       <Docs>
         <param name="provider">The <see cref="T:Microsoft.Extensions.Logging.ILoggerProvider" /> to add.</param>
-        <summary>Adds the given provider to those used in creating <see cref="T:Microsoft.Extensions.Logging.ILogger" /> instances.</summary>
+        <summary>Adds the specified provider to the collection of providers used in creating <see cref="T:Microsoft.Extensions.Logging.ILogger" /> instances.</summary>
         <remarks>To be added.</remarks>
+        <exception cref="T:System.ArgumentNullException">
+          <paramref name="provider" /> is <see langword="null" />.</exception>
       </Docs>
     </Member>
     <Member MemberName="CheckDisposed">
@@ -227,7 +229,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>Check if the factory has been disposed.</summary>
+        <summary>Checks if the factory has been disposed.</summary>
         <returns>
           <see langword="true" /> if <see cref="M:Microsoft.Extensions.Logging.LoggerFactory.Dispose" /> has been called; otherwise, <see langword="false" />.</returns>
         <remarks>To be added.</remarks>
@@ -256,7 +258,7 @@
       </Parameters>
       <Docs>
         <param name="configure">A delegate to configure the <see cref="T:Microsoft.Extensions.Logging.ILoggingBuilder" />.</param>
-        <summary>Creates new instance of <see cref="T:Microsoft.Extensions.Logging.ILoggerFactory" /> configured using provided <paramref name="configure" /> delegate.</summary>
+        <summary>Creates a new instance of <see cref="T:Microsoft.Extensions.Logging.ILoggerFactory" /> that's configured using the provided <paramref name="configure" /> delegate.</summary>
         <returns>The <see cref="T:Microsoft.Extensions.Logging.ILoggerFactory" /> that was created.</returns>
         <remarks>To be added.</remarks>
       </Docs>
@@ -292,7 +294,7 @@
       </Parameters>
       <Docs>
         <param name="categoryName">The category name for messages produced by the logger.</param>
-        <summary>Creates an <see cref="T:Microsoft.Extensions.Logging.ILogger" /> with the given <paramref name="categoryName" />.</summary>
+        <summary>Creates an <see cref="T:Microsoft.Extensions.Logging.ILogger" /> with the specified <paramref name="categoryName" />.</summary>
         <returns>The <see cref="T:Microsoft.Extensions.Logging.ILogger" /> that was created.</returns>
         <remarks>To be added.</remarks>
       </Docs>