diff --git a/src/Libraries/Microsoft.Extensions.Caching.Hybrid/HybridCacheOptions.cs b/src/Libraries/Microsoft.Extensions.Caching.Hybrid/HybridCacheOptions.cs
index 982ea55a6af..473f1e3c46d 100644
--- a/src/Libraries/Microsoft.Extensions.Caching.Hybrid/HybridCacheOptions.cs
+++ b/src/Libraries/Microsoft.Extensions.Caching.Hybrid/HybridCacheOptions.cs
@@ -11,11 +11,13 @@ public class HybridCacheOptions
private const int ShiftBytesToMibiBytes = 20;
///
- /// Gets or sets the default global options to be applied to 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.
+ /// Gets or sets the default global options to be applied to 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 can choose a reasonable default.
+ ///
public HybridCacheEntryOptions? DefaultEntryOptions { get; set; }
///
@@ -24,21 +26,35 @@ public class HybridCacheOptions
public bool DisableCompression { get; set; }
///
- /// 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.
+ /// Gets or sets the maximum size of cache items.
///
- /// The default value is 1 MiB.
+ ///
+ /// The maximum size of cache items. The default value is 1 MiB.
+ ///
+ ///
+ /// Attempts to store values over this size are logged,
+ /// and the value isn't stored in the cache.
+ ///
public long MaximumPayloadBytes { get; set; } = 1 << ShiftBytesToMibiBytes; // 1MiB
///
- /// Gets or sets the maximum permitted length (in characters) of keys; attempts to use keys over this size will be logged.
+ /// Gets or sets the maximum permitted length (in characters) of keys.
///
- /// The default value is 1024 characters.
+ ///
+ /// The maximum permitted length of keys, in characters. The default value is 1024 characters.
+ ///
+ /// Attempts to use keys over this size are logged.
public int MaximumKeyLength { get; set; } = 1024; // characters
///
- /// 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.
+ /// Gets or sets a value indicating whether to use "tags" data as dimensions on metric reporting.
///
+ ///
+ /// to use "tags" data as dimensions on metric reporting; otherwise, .
+ ///
+ ///
+ /// If enabled, take care to ensure that tags don't contain data that
+ /// should not be visible in metrics systems.
+ ///
public bool ReportTagMetrics { get; set; }
}