Merge pull request #7203 from umbraco/cms/update-nucacheserializertype

Clarified usage of NuCacheSerializerType setting

Author: eshanrnh

15/umbraco-cms/reference/configuration/cache-settings.md

@@ -184,29 +184,12 @@ Specifying the `SqlPageSize` will change the size of the paged SQL queries. The
 
 ## NuCacheSerializerType
 
-The `NuCacheSerializerType` setting allows developers to specify the serialization format for NuCache content. This setting is particularly relevant for projects migrating from older versions of Umbraco that relied on JSON formats.
+The `NuCacheSerializerType` setting allows developers to specify the serialization format for cached content.
 
-To use JSON serialization instead of the default MessagePack:
+The fastest and most compact format `MessagePack` is used by default.
 
-### Using 'Program.cs'
+An alternate `JSON` option was provided for backward compatibility for the Umbraco cache implementation used from Umbraco 8 to 14 (NuCache).
 
-```csharp
-builder.Services.Configure<NuCacheSettings>(options =>
-{
-    options.NuCacheSerializerType = NuCacheSerializerType.JSON;
-});
-```
+It is no longer supported with the cache implementation from Umbraco 15+ based on .NET's Hybrid cache.
 
-### Using 'appsettings.json'
-
-```csharp
-{
-  "Umbraco": {
-    "CMS": {
-      "NuCache": {
-        "NuCacheSerializerType": "JSON"
-      }
-    }
-  }
-}
-```
+The option is kept available only for a more readable format suitable for testing purposes.

16/umbraco-cms/reference/configuration/cache-settings.md

@@ -1,5 +1,5 @@
 ---
-description: Information on the Cache settings section 
+description: Information on the Cache settings section
 ---
 
 # Cache Settings
@@ -186,29 +186,12 @@ Specifying the `SqlPageSize` will change the size of the paged SQL queries. The
 
 ## NuCacheSerializerType
 
-The `NuCacheSerializerType` setting allows developers to specify the serialization format for NuCache content. This setting is particularly relevant for projects migrating from older versions of Umbraco that relied on JSON formats.
+The `NuCacheSerializerType` setting allows developers to specify the serialization format for cached content.
 
-To use JSON serialization instead of the default MessagePack:
+The fastest and most compact format `MessagePack` is used by default.
 
-### Using 'Program.cs'
+An alternate `JSON` option was provided for backward compatibility for the Umbraco cache implementation used from Umbraco 8 to 14 (NuCache).
 
-```csharp
-builder.Services.Configure<NuCacheSettings>(options =>
-{
-    options.NuCacheSerializerType = NuCacheSerializerType.JSON;
-});
-```
+It is no longer supported with the cache implementation from Umbraco 15+ based on .NET's Hybrid cache.
 
-### Using 'appsettings.json'
-
-```csharp
-{
-  "Umbraco": {
-    "CMS": {
-      "NuCache": {
-        "NuCacheSerializerType": "JSON"
-      }
-    }
-  }
-}
-```
+The option is kept available only for a more readable format suitable for testing purposes.