Add the upgrade guide for ServicePlatform Connector Version 3 to 4 (#7798)

* Add the upgrade guide for ServicePlatform Connector Version 3 to 4

* Add snippets to the migration guide

* Wording improvements

* A empty line

* Editorial tweaks

* Add summary

---------

Co-authored-by: Brandon Ording <[email protected]>

Author: tamararivera

Snippets/PlatformConnector/PlatformConnector_3/UpgradeGuides/3to4/TimeToBeReceived.cs

@@ -0,0 +1,22 @@
+using System;
+using NServiceBus;
+
+public class TimeToBeReceived
+{
+    public static void Usage(EndpointConfiguration endpointConfiguration)
+    {
+#pragma warning disable CS0618 // Type or member is obsolete
+        #region PlatformConnector-3to4-TimeToBeReceived
+        var platformConnection = new ServicePlatformConnectionConfiguration
+        {
+            Metrics = new ServicePlatformMetricsConfiguration
+            {
+                TimeToBeReceived = TimeSpan.FromSeconds(60)
+            }
+        };
+
+        endpointConfiguration.ConnectToServicePlatform(platformConnection);
+        #endregion
+#pragma warning restore CS0618 // Type or member is obsolete
+    }
+}

Snippets/PlatformConnector/PlatformConnector_4/UpgradeGuides/3to4/TimeToBeReceived.cs

@@ -0,0 +1,22 @@
+
+
+using System;
+using NServiceBus;
+
+public class TimeToBeReceived
+{
+    public static void Usage(EndpointConfiguration endpointConfiguration)
+    {
+        #region PlatformConnector-3to4-TimeToBeReceived
+        var platformConnection = new ServicePlatformConnectionConfiguration
+        {
+            Metrics = new ServicePlatformMetricsConfiguration
+            {
+                TimeToLive = TimeSpan.FromSeconds(60)
+            }
+        };
+
+        endpointConfiguration.ConnectToServicePlatform(platformConnection);
+        #endregion
+    }
+}

menu/menu.yaml

@@ -290,7 +290,7 @@
       - Url: nservicebus/upgrades/absdatabus-1to2
         Title: Version 1 to 2
       - Url: nservicebus/upgrades/absdatabus-6to1
-        Title: Migrating off NServiceBus.Azure 
+        Title: Migrating off NServiceBus.Azure
     - Title: Azure Cloud Services Host
       Articles:
       - Url: nservicebus/upgrades/acs-host-7to8
@@ -367,6 +367,10 @@
         Title: Version 1 to 2
       - Url: nservicebus/upgrades/externalize-perfcounters
         Title: Migrate To External Nuget
+    - Title: ServicePlatform Connector
+      Articles:
+      - Url: nservicebus/upgrades/service-platform-connector-3to4
+        Title: Version 3 to 4
     - Title: ServiceControl Plugins
       Articles:
       - Url: nservicebus/upgrades/nsb6-sc-plugins-1to2
@@ -1177,7 +1181,7 @@
       - Url: persistence/upgrades/ravendb-gateway-4to5
         Title: Version 4 to 5
       - Url: persistence/upgrades/ravendb-gateway-1to2
-        Title: Version 1 to 2        
+        Title: Version 1 to 2
     - Title: SQL
       Articles:
       - Url: persistence/upgrades/sql-client4

nservicebus/upgrades/service-platform-connector-3to4.md

@@ -0,0 +1,16 @@
+---
+title: ServicePlatform Connector Upgrade Version 3 to 4
+summary: Instructions on how to upgrade the ServicePlatform Connector from version 3 to 4
+reviewed: 2025-08-29
+component: PlatformConnector
+isUpgradeGuide: true
+upgradeGuideCoreVersions:
+  - 9
+  - 10
+---
+
+## Metrics TimeToBeReceived renamed to TimeToLive
+
+In version 4, the setting to configure the maximum time to live for [Metrics messages](/platform/json-schema.md#metrics) has been renamed from `TimeToBeReceived` to `TimeToLive`. This aligns it with the naming convention of similar settings for other sections of the configuration.
+
+snippet: PlatformConnector-3to4-TimeToBeReceived