Preview4 release notes (#29)

* changelog

* Adding note

* version bump

* More comments

* changelog correction

* Missing dot

changelog.md

@@ -6,6 +6,12 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 
 ### Added
 
+## <a name="1.0.0-preview4"/> 1.0.0-preview4 - 2020-07-27
+
+### Added
+
+- [#28](https://github.com/Azure/Microsoft.Extensions.Caching.Cosmos/pull/28) Added CosmosCacheOptions.RetrySlidingExpirationUpdates to disable write retries during Get operations for highly concurrent stale item scenarios.
+
 ## <a name="1.0.0-preview3"/> 1.0.0-preview3 - 2020-07-20
 
 ### Fixed

src/CosmosCacheOptions.cs

@@ -52,8 +52,10 @@ public class CosmosCacheOptions : IOptions<CosmosCacheOptions>
         /// Gets or sets a value indicating whether to retry failed updates after a Get to an item with sliding expiration.
         /// </summary>
         /// <remarks>
-        /// This can be useful for applications with high frequency reads on the same cache item.
+        /// <para>This can be useful for applications with high frequency reads on the same cache item that does not change.</para>
+        /// <para>Turning this feature off for cache items that change constantly can lead to dirty reads. </para>
         /// </remarks>
+        /// <value>Default value is true.</value>
         public bool RetrySlidingExpirationUpdates { get; set; } = true;
 
         /// <summary>

src/CosmosDistributedCache.csproj

@@ -7,7 +7,7 @@
     <CurrentDate>$([System.DateTime]::Now.ToString(yyyyMMdd))</CurrentDate>
     <NeutralLanguage>en-US</NeutralLanguage>
     <ClientVersion>1.0.0</ClientVersion>
-    <VersionSuffix Condition=" '$(IsPreview)' == 'true' ">preview3</VersionSuffix>
+    <VersionSuffix Condition=" '$(IsPreview)' == 'true' ">preview4</VersionSuffix>
     <Version Condition=" '$(VersionSuffix)' == '' ">$(ClientVersion)</Version>
     <Version Condition=" '$(VersionSuffix)' != '' ">$(ClientVersion)-$(VersionSuffix)</Version>
     <FileVersion>$(ClientVersion)</FileVersion>