From 94d72a94a947aae9fa6f0f81b57ff968ccff8c2a Mon Sep 17 00:00:00 2001
From: Maryam Ariyan <maryam.ariyan@microsoft.com>
Date: Mon, 13 Apr 2020 17:22:56 -0700
Subject: [PATCH 1/2] More docs on: - Microsoft.Extensions.Caching.Memory -
 Microsoft.Extensions.Configuration - Microsoft.Extensions.DependencyInjection

---
 .../MemoryCache.xml                           | 15 +++---
 .../MemoryCacheOptions.xml                    |  4 +-
 .../ChainedConfigurationProvider.xml          |  4 +-
 .../ConfigurationRoot.xml                     |  4 +-
 .../FileConfigurationProvider.xml             |  4 +-
 .../FakeService.xml                           |  4 +-
 .../DefaultServiceProviderFactory.xml         | 10 ++--
 .../ServiceCollection.xml                     | 52 +++++++++++--------
 .../ServiceProvider.xml                       |  8 +--
 9 files changed, 58 insertions(+), 47 deletions(-)

diff --git a/xml/Microsoft.Extensions.Caching.Memory/MemoryCache.xml b/xml/Microsoft.Extensions.Caching.Memory/MemoryCache.xml
index e9d5552b2d1..a6f3e03abe8 100644
--- a/xml/Microsoft.Extensions.Caching.Memory/MemoryCache.xml
+++ b/xml/Microsoft.Extensions.Caching.Memory/MemoryCache.xml
@@ -1,4 +1,4 @@
-<Type Name="MemoryCache" FullName="Microsoft.Extensions.Caching.Memory.MemoryCache">
+<Type Name="MemoryCache" FullName="Microsoft.Extensions.Caching.Memory.MemoryCache">
   <TypeSignature Language="C#" Value="public class MemoryCache : IDisposable, Microsoft.Extensions.Caching.Memory.IMemoryCache" />
   <TypeSignature Language="ILAsm" Value=".class public auto ansi beforefieldinit MemoryCache extends System.Object implements class Microsoft.Extensions.Caching.Memory.IMemoryCache, class System.IDisposable" />
   <TypeSignature Language="DocId" Value="T:Microsoft.Extensions.Caching.Memory.MemoryCache" />
@@ -169,8 +169,8 @@
       </Parameters>
       <Docs>
         <param name="key">To be added.</param>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
+        <summary>Create or overwrite an entry in the cache.</summary>
+        <returns>The newly created <see cref="T:Microsoft.Extensions.Caching.Memory.ICacheEntry" /> instance.</returns>
         <remarks>To be added.</remarks>
         <inheritdoc />
       </Docs>
@@ -201,7 +201,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added.</summary>
+        <summary>Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources.</summary>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -291,7 +291,7 @@
       </Parameters>
       <Docs>
         <param name="key">To be added.</param>
-        <summary>To be added.</summary>
+        <summary>Removes the object associated with the given key.</summary>
         <remarks>To be added.</remarks>
         <inheritdoc />
       </Docs>
@@ -327,8 +327,9 @@
       <Docs>
         <param name="key">To be added.</param>
         <param name="result">To be added.</param>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
+        <summary>Gets the item associated with this key if present.</summary>
+        <returns>
+          <see langword="true" /> if the key was found.</returns>
         <remarks>To be added.</remarks>
         <inheritdoc />
       </Docs>
diff --git a/xml/Microsoft.Extensions.Caching.Memory/MemoryCacheOptions.xml b/xml/Microsoft.Extensions.Caching.Memory/MemoryCacheOptions.xml
index ca59daf826f..b9f3c3f7283 100644
--- a/xml/Microsoft.Extensions.Caching.Memory/MemoryCacheOptions.xml
+++ b/xml/Microsoft.Extensions.Caching.Memory/MemoryCacheOptions.xml
@@ -1,4 +1,4 @@
-<Type Name="MemoryCacheOptions" FullName="Microsoft.Extensions.Caching.Memory.MemoryCacheOptions">
+<Type Name="MemoryCacheOptions" FullName="Microsoft.Extensions.Caching.Memory.MemoryCacheOptions">
   <TypeSignature Language="C#" Value="public class MemoryCacheOptions : Microsoft.Extensions.Options.IOptions&lt;Microsoft.Extensions.Caching.Memory.MemoryCacheOptions&gt;" />
   <TypeSignature Language="ILAsm" Value=".class public auto ansi beforefieldinit MemoryCacheOptions extends System.Object implements class Microsoft.Extensions.Options.IOptions`1&lt;class Microsoft.Extensions.Caching.Memory.MemoryCacheOptions&gt;" />
   <TypeSignature Language="DocId" Value="T:Microsoft.Extensions.Caching.Memory.MemoryCacheOptions" />
@@ -185,7 +185,7 @@
         <ReturnType>Microsoft.Extensions.Caching.Memory.MemoryCacheOptions</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>Gets the default configured <typeparamref name="TOptions" /> instance.</summary>
         <value>To be added.</value>
         <remarks>To be added.</remarks>
       </Docs>
diff --git a/xml/Microsoft.Extensions.Configuration/ChainedConfigurationProvider.xml b/xml/Microsoft.Extensions.Configuration/ChainedConfigurationProvider.xml
index 869a4ce63c4..9952abea65b 100644
--- a/xml/Microsoft.Extensions.Configuration/ChainedConfigurationProvider.xml
+++ b/xml/Microsoft.Extensions.Configuration/ChainedConfigurationProvider.xml
@@ -1,4 +1,4 @@
-<Type Name="ChainedConfigurationProvider" FullName="Microsoft.Extensions.Configuration.ChainedConfigurationProvider">
+<Type Name="ChainedConfigurationProvider" FullName="Microsoft.Extensions.Configuration.ChainedConfigurationProvider">
   <TypeSignature Language="C#" Value="public class ChainedConfigurationProvider : Microsoft.Extensions.Configuration.IConfigurationProvider" FrameworkAlternate="dotnet-plat-ext-2.1;dotnet-plat-ext-2.2" />
   <TypeSignature Language="ILAsm" Value=".class public auto ansi beforefieldinit ChainedConfigurationProvider extends System.Object implements class Microsoft.Extensions.Configuration.IConfigurationProvider" FrameworkAlternate="dotnet-plat-ext-2.1;dotnet-plat-ext-2.2" />
   <TypeSignature Language="DocId" Value="T:Microsoft.Extensions.Configuration.ChainedConfigurationProvider" />
@@ -78,7 +78,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added.</summary>
+        <summary>Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources.</summary>
         <remarks>To be added.</remarks>
         <inheritdoc />
       </Docs>
diff --git a/xml/Microsoft.Extensions.Configuration/ConfigurationRoot.xml b/xml/Microsoft.Extensions.Configuration/ConfigurationRoot.xml
index 766d62bb06c..12b166488a7 100644
--- a/xml/Microsoft.Extensions.Configuration/ConfigurationRoot.xml
+++ b/xml/Microsoft.Extensions.Configuration/ConfigurationRoot.xml
@@ -1,4 +1,4 @@
-<Type Name="ConfigurationRoot" FullName="Microsoft.Extensions.Configuration.ConfigurationRoot">
+<Type Name="ConfigurationRoot" FullName="Microsoft.Extensions.Configuration.ConfigurationRoot">
   <TypeSignature Language="C#" Value="public class ConfigurationRoot : Microsoft.Extensions.Configuration.IConfigurationRoot" FrameworkAlternate="dotnet-plat-ext-1.0;dotnet-plat-ext-1.1;dotnet-plat-ext-2.0;dotnet-plat-ext-2.1;dotnet-plat-ext-2.2" />
   <TypeSignature Language="ILAsm" Value=".class public auto ansi beforefieldinit ConfigurationRoot extends System.Object implements class Microsoft.Extensions.Configuration.IConfiguration, class Microsoft.Extensions.Configuration.IConfigurationRoot" FrameworkAlternate="dotnet-plat-ext-1.0;dotnet-plat-ext-1.1;dotnet-plat-ext-2.0;dotnet-plat-ext-2.1;dotnet-plat-ext-2.2" />
   <TypeSignature Language="DocId" Value="T:Microsoft.Extensions.Configuration.ConfigurationRoot" />
@@ -88,7 +88,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added.</summary>
+        <summary>Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources.</summary>
         <remarks>To be added.</remarks>
         <inheritdoc />
       </Docs>
diff --git a/xml/Microsoft.Extensions.Configuration/FileConfigurationProvider.xml b/xml/Microsoft.Extensions.Configuration/FileConfigurationProvider.xml
index b4cab740324..9c49e8a4f17 100644
--- a/xml/Microsoft.Extensions.Configuration/FileConfigurationProvider.xml
+++ b/xml/Microsoft.Extensions.Configuration/FileConfigurationProvider.xml
@@ -1,4 +1,4 @@
-<Type Name="FileConfigurationProvider" FullName="Microsoft.Extensions.Configuration.FileConfigurationProvider">
+<Type Name="FileConfigurationProvider" FullName="Microsoft.Extensions.Configuration.FileConfigurationProvider">
   <TypeSignature Language="C#" Value="public abstract class FileConfigurationProvider : Microsoft.Extensions.Configuration.ConfigurationProvider" FrameworkAlternate="dotnet-plat-ext-1.0;dotnet-plat-ext-1.1;dotnet-plat-ext-2.0;dotnet-plat-ext-2.1;dotnet-plat-ext-2.2" />
   <TypeSignature Language="ILAsm" Value=".class public auto ansi abstract beforefieldinit FileConfigurationProvider extends Microsoft.Extensions.Configuration.ConfigurationProvider" FrameworkAlternate="dotnet-plat-ext-1.0;dotnet-plat-ext-1.1;dotnet-plat-ext-2.0;dotnet-plat-ext-2.1;dotnet-plat-ext-2.2" />
   <TypeSignature Language="DocId" Value="T:Microsoft.Extensions.Configuration.FileConfigurationProvider" />
@@ -81,7 +81,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added.</summary>
+        <summary>Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources.</summary>
         <remarks>To be added.</remarks>
         <inheritdoc />
       </Docs>
diff --git a/xml/Microsoft.Extensions.DependencyInjection.Specification.Fakes/FakeService.xml b/xml/Microsoft.Extensions.DependencyInjection.Specification.Fakes/FakeService.xml
index 227ec468100..a28652cdac6 100644
--- a/xml/Microsoft.Extensions.DependencyInjection.Specification.Fakes/FakeService.xml
+++ b/xml/Microsoft.Extensions.DependencyInjection.Specification.Fakes/FakeService.xml
@@ -1,4 +1,4 @@
-<Type Name="FakeService" FullName="Microsoft.Extensions.DependencyInjection.Specification.Fakes.FakeService">
+<Type Name="FakeService" FullName="Microsoft.Extensions.DependencyInjection.Specification.Fakes.FakeService">
   <TypeSignature Language="C#" Value="public class FakeService : IDisposable, Microsoft.Extensions.DependencyInjection.Specification.Fakes.IFakeEveryService, Microsoft.Extensions.DependencyInjection.Specification.Fakes.IFakeOpenGenericService&lt;Microsoft.Extensions.DependencyInjection.Specification.Fakes.PocoClass&gt;" />
   <TypeSignature Language="ILAsm" Value=".class public auto ansi beforefieldinit FakeService extends System.Object implements class Microsoft.Extensions.DependencyInjection.Specification.Fakes.IFakeEveryService, class Microsoft.Extensions.DependencyInjection.Specification.Fakes.IFakeMultipleService, class Microsoft.Extensions.DependencyInjection.Specification.Fakes.IFakeOpenGenericService`1&lt;class Microsoft.Extensions.DependencyInjection.Specification.Fakes.PocoClass&gt;, class Microsoft.Extensions.DependencyInjection.Specification.Fakes.IFakeScopedService, class Microsoft.Extensions.DependencyInjection.Specification.Fakes.IFakeService, class Microsoft.Extensions.DependencyInjection.Specification.Fakes.IFakeServiceInstance, class Microsoft.Extensions.DependencyInjection.Specification.Fakes.IFakeSingletonService, class System.IDisposable" />
   <TypeSignature Language="DocId" Value="T:Microsoft.Extensions.DependencyInjection.Specification.Fakes.FakeService" />
@@ -89,7 +89,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added.</summary>
+        <summary>Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources.</summary>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
diff --git a/xml/Microsoft.Extensions.DependencyInjection/DefaultServiceProviderFactory.xml b/xml/Microsoft.Extensions.DependencyInjection/DefaultServiceProviderFactory.xml
index 3d34175a3ce..02cf4bf97be 100644
--- a/xml/Microsoft.Extensions.DependencyInjection/DefaultServiceProviderFactory.xml
+++ b/xml/Microsoft.Extensions.DependencyInjection/DefaultServiceProviderFactory.xml
@@ -1,4 +1,4 @@
-<Type Name="DefaultServiceProviderFactory" FullName="Microsoft.Extensions.DependencyInjection.DefaultServiceProviderFactory">
+<Type Name="DefaultServiceProviderFactory" FullName="Microsoft.Extensions.DependencyInjection.DefaultServiceProviderFactory">
   <TypeSignature Language="C#" Value="public class DefaultServiceProviderFactory : Microsoft.Extensions.DependencyInjection.IServiceProviderFactory&lt;Microsoft.Extensions.DependencyInjection.IServiceCollection&gt;" />
   <TypeSignature Language="ILAsm" Value=".class public auto ansi beforefieldinit DefaultServiceProviderFactory extends System.Object implements class Microsoft.Extensions.DependencyInjection.IServiceProviderFactory`1&lt;class Microsoft.Extensions.DependencyInjection.IServiceCollection&gt;" />
   <TypeSignature Language="DocId" Value="T:Microsoft.Extensions.DependencyInjection.DefaultServiceProviderFactory" />
@@ -105,8 +105,8 @@
       </Parameters>
       <Docs>
         <param name="services">To be added.</param>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
+        <summary>Creates a container builder from an <see cref="T:Microsoft.Extensions.DependencyInjection.IServiceCollection" />.</summary>
+        <returns>A container builder that can be used to create an <see cref="T:System.IServiceProvider" />.</returns>
         <remarks>To be added.</remarks>
         <inheritdoc />
       </Docs>
@@ -139,8 +139,8 @@
       </Parameters>
       <Docs>
         <param name="containerBuilder">To be added.</param>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
+        <summary>Creates an <see cref="T:System.IServiceProvider" /> from the container builder.</summary>
+        <returns>An <see cref="T:System.IServiceProvider" /></returns>
         <remarks>To be added.</remarks>
         <inheritdoc />
       </Docs>
diff --git a/xml/Microsoft.Extensions.DependencyInjection/ServiceCollection.xml b/xml/Microsoft.Extensions.DependencyInjection/ServiceCollection.xml
index ce094b90900..942ff9f52c6 100644
--- a/xml/Microsoft.Extensions.DependencyInjection/ServiceCollection.xml
+++ b/xml/Microsoft.Extensions.DependencyInjection/ServiceCollection.xml
@@ -1,4 +1,4 @@
-<Type Name="ServiceCollection" FullName="Microsoft.Extensions.DependencyInjection.ServiceCollection">
+<Type Name="ServiceCollection" FullName="Microsoft.Extensions.DependencyInjection.ServiceCollection">
   <TypeSignature Language="C#" Value="public class ServiceCollection : Microsoft.Extensions.DependencyInjection.IServiceCollection, System.Collections.Generic.ICollection&lt;Microsoft.Extensions.DependencyInjection.ServiceDescriptor&gt;, System.Collections.Generic.IEnumerable&lt;Microsoft.Extensions.DependencyInjection.ServiceDescriptor&gt;, System.Collections.Generic.IList&lt;Microsoft.Extensions.DependencyInjection.ServiceDescriptor&gt;" />
   <TypeSignature Language="ILAsm" Value=".class public auto ansi beforefieldinit ServiceCollection extends System.Object implements class Microsoft.Extensions.DependencyInjection.IServiceCollection, class System.Collections.Generic.ICollection`1&lt;class Microsoft.Extensions.DependencyInjection.ServiceDescriptor&gt;, class System.Collections.Generic.IEnumerable`1&lt;class Microsoft.Extensions.DependencyInjection.ServiceDescriptor&gt;, class System.Collections.Generic.IList`1&lt;class Microsoft.Extensions.DependencyInjection.ServiceDescriptor&gt;, class System.Collections.IEnumerable" />
   <TypeSignature Language="DocId" Value="T:Microsoft.Extensions.DependencyInjection.ServiceCollection" />
@@ -96,7 +96,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added.</summary>
+        <summary>Removes all items from the <see cref="T:System.Collections.Generic.ICollection`1" />.</summary>
         <remarks>To be added.</remarks>
         <inheritdoc />
       </Docs>
@@ -130,8 +130,9 @@
       </Parameters>
       <Docs>
         <param name="item">To be added.</param>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
+        <summary>Determines whether the <see cref="T:System.Collections.Generic.ICollection`1" /> contains a specific value.</summary>
+        <returns>
+          <see langword="true" /> if <paramref name="item" /> is found in the <see cref="T:System.Collections.Generic.ICollection`1" />; otherwise, <see langword="false" />.</returns>
         <remarks>To be added.</remarks>
         <inheritdoc />
       </Docs>
@@ -167,7 +168,7 @@
       <Docs>
         <param name="array">To be added.</param>
         <param name="arrayIndex">To be added.</param>
-        <summary>To be added.</summary>
+        <summary>Copies the elements of the <see cref="T:System.Collections.Generic.ICollection`1" /> to an <see cref="T:System.Array" />, starting at a particular <see cref="T:System.Array" /> index.</summary>
         <remarks>To be added.</remarks>
         <inheritdoc />
       </Docs>
@@ -197,7 +198,7 @@
         <ReturnType>System.Int32</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>Gets the number of elements contained in the <see cref="T:System.Collections.Generic.ICollection`1" />.</summary>
         <value>To be added.</value>
         <remarks>To be added.</remarks>
         <inheritdoc />
@@ -229,8 +230,8 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
+        <summary>Returns an enumerator that iterates through the collection.</summary>
+        <returns>An enumerator that can be used to iterate through the collection.</returns>
         <remarks>To be added.</remarks>
         <inheritdoc />
       </Docs>
@@ -264,8 +265,8 @@
       </Parameters>
       <Docs>
         <param name="item">To be added.</param>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
+        <summary>Determines the index of a specific item in the <see cref="T:System.Collections.Generic.IList`1" />.</summary>
+        <returns>The index of <paramref name="item" /> if found in the list; otherwise, -1.</returns>
         <remarks>To be added.</remarks>
         <inheritdoc />
       </Docs>
@@ -301,7 +302,7 @@
       <Docs>
         <param name="index">To be added.</param>
         <param name="item">To be added.</param>
-        <summary>To be added.</summary>
+        <summary>Inserts an item to the <see cref="T:System.Collections.Generic.IList`1" /> at the specified index.</summary>
         <remarks>To be added.</remarks>
         <inheritdoc />
       </Docs>
@@ -331,7 +332,7 @@
         <ReturnType>System.Boolean</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>Gets a value indicating whether the <see cref="T:System.Collections.Generic.ICollection`1" /> is read-only.</summary>
         <value>To be added.</value>
         <remarks>To be added.</remarks>
         <inheritdoc />
@@ -366,7 +367,7 @@
       </Parameters>
       <Docs>
         <param name="index">To be added.</param>
-        <summary>To be added.</summary>
+        <summary>Gets or sets the element at the specified index.</summary>
         <value>To be added.</value>
         <remarks>To be added.</remarks>
         <inheritdoc />
@@ -401,8 +402,9 @@
       </Parameters>
       <Docs>
         <param name="item">To be added.</param>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
+        <summary>Removes the first occurrence of a specific object from the <see cref="T:System.Collections.Generic.ICollection`1" />.</summary>
+        <returns>
+          <see langword="true" /> if <paramref name="item" /> was successfully removed from the <see cref="T:System.Collections.Generic.ICollection`1" />; otherwise, <see langword="false" />. This method also returns <see langword="false" /> if <paramref name="item" /> is not found in the original <see cref="T:System.Collections.Generic.ICollection`1" />.</returns>
         <remarks>To be added.</remarks>
         <inheritdoc />
       </Docs>
@@ -436,7 +438,7 @@
       </Parameters>
       <Docs>
         <param name="index">To be added.</param>
-        <summary>To be added.</summary>
+        <summary>Removes the <see cref="T:System.Collections.Generic.IList`1" /> item at the specified index.</summary>
         <remarks>To be added.</remarks>
         <inheritdoc />
       </Docs>
@@ -469,8 +471,8 @@
         <Parameter Name="item" Type="Microsoft.Extensions.DependencyInjection.ServiceDescriptor" />
       </Parameters>
       <Docs>
-        <param name="item">To be added.</param>
-        <summary>To be added.</summary>
+        <param name="item">The object to add to the <see cref="T:System.Collections.Generic.ICollection`1" />.</param>
+        <summary>Adds an item to the <see cref="T:System.Collections.Generic.ICollection`1" />.</summary>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -500,9 +502,17 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
-        <remarks>To be added.</remarks>
+        <summary>Returns an enumerator that iterates through a collection.</summary>
+        <returns>An <see cref="T:System.Collections.IEnumerator" /> object that can be used to iterate through the collection.</returns>
+        <remarks>
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+
+This member is an explicit interface member implementation. It can be used only when the <xref:Microsoft.Extensions.DependencyInjection.ServiceCollection> instance is cast to an <xref:System.Collections.IEnumerable> interface.
+
+          ]]></format>
+        </remarks>
       </Docs>
     </Member>
   </Members>
diff --git a/xml/Microsoft.Extensions.DependencyInjection/ServiceProvider.xml b/xml/Microsoft.Extensions.DependencyInjection/ServiceProvider.xml
index 6b15ae98c95..c685aee5120 100644
--- a/xml/Microsoft.Extensions.DependencyInjection/ServiceProvider.xml
+++ b/xml/Microsoft.Extensions.DependencyInjection/ServiceProvider.xml
@@ -1,4 +1,4 @@
-<Type Name="ServiceProvider" FullName="Microsoft.Extensions.DependencyInjection.ServiceProvider">
+<Type Name="ServiceProvider" FullName="Microsoft.Extensions.DependencyInjection.ServiceProvider">
   <TypeSignature Language="C#" Value="public sealed class ServiceProvider : IAsyncDisposable, IDisposable, IServiceProvider" FrameworkAlternate="dotnet-plat-ext-3.0;dotnet-plat-ext-3.1" />
   <TypeSignature Language="ILAsm" Value=".class public auto ansi sealed beforefieldinit ServiceProvider extends System.Object implements class System.IAsyncDisposable, class System.IDisposable, class System.IServiceProvider" FrameworkAlternate="dotnet-plat-ext-3.0;dotnet-plat-ext-3.1" />
   <TypeSignature Language="DocId" Value="T:Microsoft.Extensions.DependencyInjection.ServiceProvider" FrameworkAlternate="dotnet-plat-ext-2.0;dotnet-plat-ext-2.1;dotnet-plat-ext-2.2;dotnet-plat-ext-3.0;dotnet-plat-ext-3.1" />
@@ -62,7 +62,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added.</summary>
+        <summary>Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources.</summary>
         <remarks>To be added.</remarks>
         <inheritdoc />
       </Docs>
@@ -88,8 +88,8 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
+        <summary>Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources asynchronously.</summary>
+        <returns>A task that represents the asynchronous dispose operation.</returns>
         <remarks>To be added.</remarks>
         <inheritdoc />
       </Docs>

From 5aa4d00d4874a6ca52a12cf42812e263d50a221a Mon Sep 17 00:00:00 2001
From: Maryam Ariyan <maryam.ariyan@microsoft.com>
Date: Wed, 2 Sep 2020 14:54:12 -0700
Subject: [PATCH 2/2] Apply suggestions from code review

Applies PR feedback

Co-authored-by: Carlos Sanchez <1175054+carlossanlop@users.noreply.github.com>
Co-authored-by: Genevieve Warren <24882762+gewarren@users.noreply.github.com>
---
 xml/Microsoft.Extensions.Caching.Memory/MemoryCache.xml         | 2 +-
 .../DefaultServiceProviderFactory.xml                           | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/xml/Microsoft.Extensions.Caching.Memory/MemoryCache.xml b/xml/Microsoft.Extensions.Caching.Memory/MemoryCache.xml
index 132b09dbb7e..332013f460c 100644
--- a/xml/Microsoft.Extensions.Caching.Memory/MemoryCache.xml
+++ b/xml/Microsoft.Extensions.Caching.Memory/MemoryCache.xml
@@ -175,7 +175,7 @@
       </Parameters>
       <Docs>
         <param name="key">To be added.</param>
-        <summary>Create or overwrite an entry in the cache.</summary>
+        <summary>Creates or overwrites an entry in the cache.</summary>
         <returns>The newly created <see cref="T:Microsoft.Extensions.Caching.Memory.ICacheEntry" /> instance.</returns>
         <remarks>To be added.</remarks>
         <inheritdoc />
diff --git a/xml/Microsoft.Extensions.DependencyInjection/DefaultServiceProviderFactory.xml b/xml/Microsoft.Extensions.DependencyInjection/DefaultServiceProviderFactory.xml
index a095a53ae02..486bb6ee052 100644
--- a/xml/Microsoft.Extensions.DependencyInjection/DefaultServiceProviderFactory.xml
+++ b/xml/Microsoft.Extensions.DependencyInjection/DefaultServiceProviderFactory.xml
@@ -145,7 +145,7 @@
       <Docs>
         <param name="containerBuilder">To be added.</param>
         <summary>Creates an <see cref="T:System.IServiceProvider" /> from the container builder.</summary>
-        <returns>An <see cref="T:System.IServiceProvider" /></returns>
+        <returns>An <see cref="T:System.IServiceProvider" />.</returns>
         <remarks>To be added.</remarks>
         <inheritdoc />
       </Docs>