Update src/Caching/Hybrid/src/Runtime/HybridCache.cs

Co-authored-by: joegoldman2 <[email protected]>
dotnet · mgravell · Apr 17, 2024 · Apr 10, 2024 · Apr 11, 2024 · Apr 11, 2024
commit 49a477f6155db4cdffc6d3020931263e91fa3060
@@ -30,14 +30,14 @@ public abstract ValueTask<T> GetOrCreateAsync<TState, T>(string key, TState stat
         HybridCacheEntryOptions? options = null, IReadOnlyCollection<string>? tags = null, CancellationToken token = default);
 
     /// <summary>
-    /// Get data from the cache, or the underlying data service if not available.
+    /// Asynchronously gets the value associated with the key if it exists, or generates a new entry using the provided key and a value from the given factory if the key is not found.
     /// </summary>
     /// <typeparam name="T">The type of the data being considered.</typeparam>
-    /// <param name="key">The unique key for this cache entry.</param>
+    /// <param name="key">The key of the entry to look for or create.</param>
     /// <param name="underlyingDataCallback">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="token">Cancellation for this operation.</param>
+    /// <param name="token">The <see cref="CancellationToken"/> used to propagate notifications that the operation should be canceled.</param>
     /// <returns>The data, either from cache or the underlying data service.</returns>
     [System.Diagnostics.CodeAnalysis.SuppressMessage("ApiDesign", "RS0026:Do not add multiple public overloads with optional parameters", Justification = "Delegate differences make this unambiguous")]
     public ValueTask<T> GetOrCreateAsync<T>(string key, Func<CancellationToken, ValueTask<T>> underlyingDataCallback,