CI Update

 Build.Reason:Manual by Genevieve Warren
 Build.Url:https://apidrop.visualstudio.com/Content%20CI/_build/results?buildId=465020&view=results
 source_repo.branch:net9-rc2
 source_repo.url:https://apidrop.visualstudio.com/_git/binaries

Author: [email protected]

xml/Microsoft.Extensions.Caching.Distributed/DistributedCacheEntryExtensions.xml

@@ -36,7 +36,7 @@
   </Attributes>
   <Docs>
     <summary>
-            Extension methods for <see cref="T:Microsoft.Extensions.Caching.Distributed.DistributedCacheEntryOptions" /> operations.
+            Provides extension methods for <see cref="T:Microsoft.Extensions.Caching.Distributed.DistributedCacheEntryOptions" /> operations.
             </summary>
     <remarks>To be added.</remarks>
   </Docs>

xml/Microsoft.Extensions.Caching.Distributed/DistributedCacheEntryOptions.xml

@@ -115,7 +115,7 @@
       </ReturnValue>
       <Docs>
         <summary>
-            Gets or sets how long a cache entry can be inactive (e.g. not accessed) before it will be removed.
+            Gets or sets how long a cache entry can be inactive (for example, not accessed) before it will be removed.
             This will not extend the entry lifetime beyond the absolute expiration (if set).
             </summary>
         <value>To be added.</value>

xml/Microsoft.Extensions.Caching.Distributed/DistributedCacheExtensions.xml

@@ -132,7 +132,8 @@
             Sets a sequence of bytes in the specified cache with the specified key.
             </summary>
         <remarks>To be added.</remarks>
-        <exception cref="T:System.ArgumentNullException">Thrown when <paramref name="key" /> or <paramref name="value" /> is null.</exception>
+        <exception cref="T:System.ArgumentNullException">
+          <paramref name="key" /> or <paramref name="value" /> is null.</exception>
       </Docs>
     </Member>
     <Member MemberName="SetAsync">
@@ -167,7 +168,8 @@
         <returns>A task that represents the asynchronous set operation.</returns>
         <remarks>This method stores in the task it returns all non-usage exceptions that the method's synchronous counterpart can throw. If an exception is stored into the returned task, that exception will be thrown when the task is awaited. Usage exceptions, such as <see cref="T:System.ArgumentException" />, are still thrown synchronously. For the stored exceptions, see the exceptions thrown by <see cref="M:Microsoft.Extensions.Caching.Distributed.DistributedCacheExtensions.Set(Microsoft.Extensions.Caching.Distributed.IDistributedCache,System.String,System.Byte[])" />.</remarks>
         <exception cref="T:System.OperationCanceledException">The cancellation token was canceled. This exception is stored into the returned task.</exception>
-        <exception cref="T:System.ArgumentNullException">Thrown when <paramref name="key" /> or <paramref name="value" /> is null.</exception>
+        <exception cref="T:System.ArgumentNullException">
+          <paramref name="key" /> or <paramref name="value" /> is null.</exception>
       </Docs>
     </Member>
     <Member MemberName="SetString">
@@ -199,7 +201,8 @@
             Sets a string in the specified cache with the specified key.
             </summary>
         <remarks>To be added.</remarks>
-        <exception cref="T:System.ArgumentNullException">Thrown when <paramref name="key" /> or <paramref name="value" /> is null.</exception>
+        <exception cref="T:System.ArgumentNullException">
+          <paramref name="key" /> or <paramref name="value" /> is null.</exception>
       </Docs>
     </Member>
     <Member MemberName="SetString">
@@ -233,7 +236,8 @@
             Sets a string in the specified cache with the specified key.
             </summary>
         <remarks>To be added.</remarks>
-        <exception cref="T:System.ArgumentNullException">Thrown when <paramref name="key" /> or <paramref name="value" /> is null.</exception>
+        <exception cref="T:System.ArgumentNullException">
+          <paramref name="key" /> or <paramref name="value" /> is null.</exception>
       </Docs>
     </Member>
     <Member MemberName="SetStringAsync">
@@ -268,7 +272,8 @@
         <returns>A task that represents the asynchronous set operation.</returns>
         <remarks>This method stores in the task it returns all non-usage exceptions that the method's synchronous counterpart can throw. If an exception is stored into the returned task, that exception will be thrown when the task is awaited. Usage exceptions, such as <see cref="T:System.ArgumentException" />, are still thrown synchronously. For the stored exceptions, see the exceptions thrown by <see cref="M:Microsoft.Extensions.Caching.Distributed.DistributedCacheExtensions.SetString(Microsoft.Extensions.Caching.Distributed.IDistributedCache,System.String,System.String)" />.</remarks>
         <exception cref="T:System.OperationCanceledException">The cancellation token was canceled. This exception is stored into the returned task.</exception>
-        <exception cref="T:System.ArgumentNullException">Thrown when <paramref name="key" /> or <paramref name="value" /> is null.</exception>
+        <exception cref="T:System.ArgumentNullException">
+          <paramref name="key" /> or <paramref name="value" /> is null.</exception>
       </Docs>
     </Member>
     <Member MemberName="SetStringAsync">
@@ -305,7 +310,8 @@
         <returns>A task that represents the asynchronous set operation.</returns>
         <remarks>This method stores in the task it returns all non-usage exceptions that the method's synchronous counterpart can throw. If an exception is stored into the returned task, that exception will be thrown when the task is awaited. Usage exceptions, such as <see cref="T:System.ArgumentException" />, are still thrown synchronously. For the stored exceptions, see the exceptions thrown by <see cref="M:Microsoft.Extensions.Caching.Distributed.DistributedCacheExtensions.SetString(Microsoft.Extensions.Caching.Distributed.IDistributedCache,System.String,System.String,Microsoft.Extensions.Caching.Distributed.DistributedCacheEntryOptions)" />.</remarks>
         <exception cref="T:System.OperationCanceledException">The cancellation token was canceled. This exception is stored into the returned task.</exception>
-        <exception cref="T:System.ArgumentNullException">Thrown when <paramref name="key" /> or <paramref name="value" /> is null.</exception>
+        <exception cref="T:System.ArgumentNullException">
+          <paramref name="key" /> or <paramref name="value" /> is null.</exception>
       </Docs>
     </Member>
   </Members>

xml/Microsoft.Extensions.Caching.Distributed/IBufferDistributedCache.xml

@@ -69,7 +69,7 @@
         <summary>
             Sets or overwrites a cache item.
             </summary>
-        <remarks>This is functionally similar to <see cref="M:Microsoft.Extensions.Caching.Distributed.IDistributedCache.Set(System.String,System.Byte[],Microsoft.Extensions.Caching.Distributed.DistributedCacheEntryOptions)" />, but avoids the array allocation.</remarks>
+        <remarks>This method is functionally similar to <see cref="M:Microsoft.Extensions.Caching.Distributed.IDistributedCache.Set(System.String,System.Byte[],Microsoft.Extensions.Caching.Distributed.DistributedCacheEntryOptions)" />, but avoids the array allocation.</remarks>
       </Docs>
     </Member>
     <Member MemberName="SetAsync">
@@ -112,7 +112,7 @@
             Asynchronously sets or overwrites a cache entry.
             </summary>
         <returns>To be added.</returns>
-        <remarks>This is functionally similar to <see cref="M:Microsoft.Extensions.Caching.Distributed.IDistributedCache.SetAsync(System.String,System.Byte[],Microsoft.Extensions.Caching.Distributed.DistributedCacheEntryOptions,System.Threading.CancellationToken)" />, but avoids the array allocation.</remarks>
+        <remarks>This method is functionally similar to <see cref="M:Microsoft.Extensions.Caching.Distributed.IDistributedCache.SetAsync(System.String,System.Byte[],Microsoft.Extensions.Caching.Distributed.DistributedCacheEntryOptions,System.Threading.CancellationToken)" />, but avoids the array allocation.</remarks>
       </Docs>
     </Member>
     <Member MemberName="TryGet">
@@ -142,11 +142,11 @@
         <param name="key">The unique key for the cache item.</param>
         <param name="destination">The target to write the cache contents on success.</param>
         <summary>
-            Attempt to retrieve an existing cache item.
+            Attempts to retrieve an existing cache item.
             </summary>
         <returns>
           <c>true</c> if the cache item is found, <c>false</c> otherwise.</returns>
-        <remarks>This is functionally similar to <see cref="M:Microsoft.Extensions.Caching.Distributed.IDistributedCache.Get(System.String)" />, but avoids the array allocation.</remarks>
+        <remarks>This method is functionally similar to <see cref="M:Microsoft.Extensions.Caching.Distributed.IDistributedCache.Get(System.String)" />, but avoids the array allocation.</remarks>
       </Docs>
     </Member>
     <Member MemberName="TryGetAsync">
@@ -183,11 +183,11 @@
         <param name="destination">The target to write the cache contents on success.</param>
         <param name="token">The <see cref="T:System.Threading.CancellationToken" /> used to propagate notifications that the operation should be canceled.</param>
         <summary>
-            Asynchronously attempt to retrieve an existing cache entry.
+            Asynchronously attempts to retrieve an existing cache entry.
             </summary>
         <returns>
           <c>true</c> if the cache entry is found, <c>false</c> otherwise.</returns>
-        <remarks>This is functionally similar to <see cref="M:Microsoft.Extensions.Caching.Distributed.IDistributedCache.GetAsync(System.String,System.Threading.CancellationToken)" />, but avoids the array allocation.</remarks>
+        <remarks>This method is functionally similar to <see cref="M:Microsoft.Extensions.Caching.Distributed.IDistributedCache.GetAsync(System.String,System.Threading.CancellationToken)" />, but avoids the array allocation.</remarks>
       </Docs>
     </Member>
   </Members>

xml/Microsoft.Extensions.Caching.Distributed/MemoryDistributedCache.xml

@@ -40,7 +40,7 @@
   </Attributes>
   <Docs>
     <summary>
-            An implementation of <see cref="T:Microsoft.Extensions.Caching.Distributed.IDistributedCache" /> using <see cref="T:Microsoft.Extensions.Caching.Memory.IMemoryCache" />.
+            Implements <see cref="T:Microsoft.Extensions.Caching.Distributed.IDistributedCache" /> using <see cref="T:Microsoft.Extensions.Caching.Memory.IMemoryCache" />.
             </summary>
     <remarks>To be added.</remarks>
   </Docs>

xml/Microsoft.Extensions.Caching.Hybrid/HybridCache.xml

@@ -115,7 +115,7 @@
       <Docs>
         <typeparam name="T">The type of the data being considered.</typeparam>
         <param name="key">The key of the entry to look for or create.</param>
-        <param name="factory">Provides the underlying data service is the data is not available in the cache.</param>
+        <param name="factory">Provides the underlying data service if the data is not available in the cache.</param>
         <param name="options">Additional options for this cache entry.</param>
         <param name="tags">The tags to associate with this cache item.</param>
         <param name="cancellationToken">The <see cref="T:System.Threading.CancellationToken" /> used to propagate notifications that the operation should be canceled.</param>
@@ -196,8 +196,8 @@
         <typeparam name="TState">The type of additional state required by <paramref name="factory" />.</typeparam>
         <typeparam name="T">The type of the data being considered.</typeparam>
         <param name="key">The key of the entry to look for or create.</param>
+        <param name="factory">Provides the underlying data service if the data is not available in the cache.</param>
         <param name="state">The state required for <paramref name="factory" />.</param>
-        <param name="factory">Provides the underlying data service is the data is not available in the cache.</param>
         <param name="options">Additional options for this cache entry.</param>
         <param name="tags">The tags to associate with this cache item.</param>
         <param name="cancellationToken">The <see cref="T:System.Threading.CancellationToken" /> used to propagate notifications that the operation should be canceled.</param>

xml/Microsoft.Extensions.Caching.Hybrid/HybridCacheEntryOptions.xml

@@ -19,10 +19,10 @@
   <Interfaces />
   <Docs>
     <summary>
-            Additional options (expiration, etc.) that apply to a <see cref="T:Microsoft.Extensions.Caching.Hybrid.HybridCache" /> operation. When options
+            Specifies additional options (for example, expiration) that apply to a <see cref="T:Microsoft.Extensions.Caching.Hybrid.HybridCache" /> operation. When options
             can be specified at multiple levels (for example, globally and per-call), the values are composed; the
             most granular non-null value is used, with null values being inherited. If no value is specified at
-            any level, the implementation may choose a reasonable default.
+            any level, the implementation can choose a reasonable default.
             </summary>
     <remarks>To be added.</remarks>
   </Docs>

xml/Microsoft.Extensions.Caching.Hybrid/HybridCacheOptions.xml

@@ -24,7 +24,9 @@
     </Attribute>
   </Attributes>
   <Docs>
-    <summary>To be added.</summary>
+    <summary>
+            Options for configuring the default <see cref="T:Microsoft.Extensions.Caching.Hybrid.HybridCache" /> implementation.
+            </summary>
     <remarks>To be added.</remarks>
   </Docs>
   <Members>
@@ -61,7 +63,12 @@
         <ReturnType>Microsoft.Extensions.Caching.Hybrid.HybridCacheEntryOptions</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>
+            Gets or sets the default global options to be applied to <see cref="T:Microsoft.Extensions.Caching.Hybrid.HybridCache" /> operations; if options are
+            specified at the individual call level, the non-null values are merged (with the per-call
+            options being used in preference to the global options). If no value is specified for a given
+            option (globally or per-call), the implementation may choose a reasonable default.
+            </summary>
         <value>To be added.</value>
         <remarks>To be added.</remarks>
       </Docs>
@@ -82,7 +89,9 @@
         <ReturnType>System.Boolean</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>
+            Gets or sets a value indicating whether compression for this <see cref="T:Microsoft.Extensions.Caching.Hybrid.HybridCache" /> instance is disabled.
+            </summary>
         <value>To be added.</value>
         <remarks>To be added.</remarks>
       </Docs>
@@ -103,9 +112,12 @@
         <ReturnType>System.Int32</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>
+            Gets or sets the maximum permitted length (in characters) of keys; attempts to use keys over this size will be logged.
+            </summary>
         <value>To be added.</value>
         <remarks>To be added.</remarks>
+        <remark>The default value is 1024 characters.</remark>
       </Docs>
     </Member>
     <Member MemberName="MaximumPayloadBytes">
@@ -124,9 +136,12 @@
         <ReturnType>System.Int64</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>
+            Gets or sets the maximum size of cache items; attempts to store values over this size will be logged
+            and the value will not be stored in cache.
+            </summary>
         <value>To be added.</value>
-        <remarks>To be added.</remarks>
+        <remarks>The default value is 1 MiB.</remarks>
       </Docs>
     </Member>
     <Member MemberName="ReportTagMetrics">
@@ -145,7 +160,10 @@
         <ReturnType>System.Boolean</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>
+            Gets or sets a value indicating whether to use "tags" data as dimensions on metric reporting; if enabled, care should be used to ensure that
+            tags do not contain data that should not be visible in metrics systems.
+            </summary>
         <value>To be added.</value>
         <remarks>To be added.</remarks>
       </Docs>

xml/Microsoft.Extensions.Caching.Hybrid/IHybridCacheBuilder.xml

@@ -17,7 +17,9 @@
     </Attribute>
   </Attributes>
   <Docs>
-    <summary>To be added.</summary>
+    <summary>
+            Helper API for configuring <see cref="T:Microsoft.Extensions.Caching.Hybrid.HybridCache" />.
+            </summary>
     <remarks>To be added.</remarks>
   </Docs>
   <Members>
@@ -37,7 +39,9 @@
         <ReturnType>Microsoft.Extensions.DependencyInjection.IServiceCollection</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>
+            Gets the services collection associated with this instance.
+            </summary>
         <value>To be added.</value>
         <remarks>To be added.</remarks>
       </Docs>

xml/Microsoft.Extensions.Caching.Hybrid/IHybridCacheSerializerFactory.xml

@@ -64,10 +64,10 @@
         </Parameter>
       </Parameters>
       <Docs>
-        <typeparam name="T">The type being serialized/deserialized.</typeparam>
+        <typeparam name="T">The type being serialized or deserialized.</typeparam>
         <param name="serializer">The serializer.</param>
         <summary>
-            Request a serializer for the provided type, if possible.
+            Requests a serializer for the provided type, if possible.
             </summary>
         <returns>
           <c>true</c> if the factory supports this type, <c>false</c> otherwise.</returns>