Add migration details

Author: WilliamBZA

nservicebus/upgrades/9.1to9.2/index.md

@@ -29,5 +29,8 @@ The NServiceBus.ClaimCheck library is line-level compatible with NServiceBus.Dat
 
 Some care should be taken when migrating message contracts from `DataBusProperty<T>` to `ClaimCheckProperty<T>`.  While NServiceBus.DataBus and NServiceBus.ClaimCheck are line-level compatible, they are not runtime compatible.  An endpoint that is currently running NServiceBus.DataBus will not write properties that are `ClaimCheckProperty<T>` to the DataBus. The reverse is true of NServiceBus.ClaimCheck endpoints and `DataBusProperty<T>`.  To facilitate the migration, each endpoint will need a copy of the message contract that uses the supported property type.
 
-If message contracts are in their own versioned library that have been migrated to `ClamCheckProperty<T>`, it is probable NServiceBus.DataBus endpoints can remain on an older version until it can be upgraded to NServiceBus.ClaimCheck.  If message contracts are not in their own versioned library, a local copy can be made to facilitate the transition. In this case it is imperative that all class names, namespaces, and property names are exactly the same to make sure the message can be properly deserialized when it is received.
+Changing from using `DataBusProperty<T>` to specifying conventions for the claim check properties will be the easiest way to migrate whilst maintaining runtime compatibility between the new and old versions. If this is not possible, the message contracts can be versioned separately too.
 
+If message contracts are in a versioned library that has been migrated to `ClamCheckProperty<T>`, then NServiceBus.DataBus endpoints can remain on an older version of the contracts library until they can be upgraded to NServiceBus.ClaimCheck.
+
+If message contracts are not in a versioned library, a local copy of the messages can be made to facilitate the transition. In this case it is imperative that all class names, namespaces, and property names are exactly the same to make sure the message can be properly deserialized when it is received.

samples/databus/file-share-databus/DataBus_1/Receiver/Program.cs

@@ -8,7 +8,7 @@ class Program
     static async Task Main()
     {
         Console.Title = "Receiver";
-        var endpointConfiguration = new EndpointConfiguration("Samples.DataBus.Receiver");
+        var endpointConfiguration = new EndpointConfiguration("Samples.ClaimCheck.Receiver");
         var claimCheck = endpointConfiguration.UseClaimCheck<FileShareClaimCheck, SystemJsonClaimCheckSerializer>();
         claimCheck.BasePath(@"..\..\..\..\storage");
         endpointConfiguration.UseSerialization<SystemJsonSerializer>();

samples/databus/file-share-databus/DataBus_1/Sender/Program.cs

@@ -8,7 +8,7 @@ class Program
     static async Task Main()
     {
         Console.Title = "Sender";
-        var endpointConfiguration = new EndpointConfiguration("Samples.DataBus.Sender");
+        var endpointConfiguration = new EndpointConfiguration("Samples.ClaimCheck.Sender");
 
         #region ConfigureDataBus
 
@@ -21,7 +21,7 @@ static async Task Main()
         endpointConfiguration.UseSerialization<SystemJsonSerializer>();
         endpointConfiguration.UseTransport(new LearningTransport());
         var endpointInstance = await Endpoint.Start(endpointConfiguration);
-        Console.WriteLine("Press 'D' to send a databus large message");
+        Console.WriteLine("Press 'D' to send a large message");
         Console.WriteLine("Press 'N' to send a normal large message exceed the size limit and throw");
         Console.WriteLine("Press any other key to exit");
 
@@ -53,10 +53,10 @@ static async Task SendMessageLargePayload(IEndpointInstance endpointInstance)
 
         var message = new MessageWithLargePayload
         {
-            SomeProperty = "This message contains a large blob that will be sent on the data bus",
+            SomeProperty = "This message contains a large blob that will be sent on the claim check",
             LargeBlob = new ClaimCheckProperty<byte[]>(new byte[1024*1024*5]) //5MB
         };
-        await endpointInstance.Send("Samples.DataBus.Receiver", message);
+        await endpointInstance.Send("Samples.ClaimCheck.Receiver", message);
 
         #endregion
 
@@ -71,7 +71,7 @@ static async Task SendMessageTooLargePayload(IEndpointInstance endpointInstance)
         {
             LargeBlob = new byte[1024*1024*5] //5MB
         };
-        await endpointInstance.Send("Samples.DataBus.Receiver", message);
+        await endpointInstance.Send("Samples.ClaimCheck.Receiver", message);
 
         #endregion
     }

samples/databus/file-share-databus/DataBus_1/Shared/MessageWithLargePayload.cs

@@ -3,7 +3,7 @@
 
 #region MessageWithLargePayload
 
-//the data bus is allowed to clean up transmitted properties older than the TTBR
+//the implementation of the claim check pattern is allowed to clean up transmitted properties older than the TTBR
 [TimeToBeReceived("00:01:00")]
 public class MessageWithLargePayload :
     ICommand