docs: improve comments in serialization doc

BEagle1984 · Aug 29, 2021 · 387ef05 · 387ef05
1 parent 4483fb2
commit 387ef05
Showing 1 changed file with 26 additions and 9 deletions.
diff --git a/docs/concepts/broker/serialization.md b/docs/concepts/broker/serialization.md
@@ -40,22 +40,28 @@ public class MyEndpointsConfigurator : IEndpointsConfigurator
                     .ProduceTo("inventory-events")
                     .SerializeAsJson(serializer => serializer
                         .UseFixedType<InventoryEvent>()))
-                // The following configurations are equivalent, the second
-                // one being more implicit
-                .AddInbound(endpoint => endpoint
+
+                // Specifying the message type will automatically
+                // switch to the JsonMessageSerializer<TMessage>
+                // and deserialize the specified type without
+                // needing the type header
+                .AddInbound<OrderEvent>(endpoint => endpoint
                     .ConsumeFrom("order-events")
                     .Configure(config => 
                         {
                             config.GroupId = "my-consumer";
-                        })
-                    .DeserializeJson(serializer => serializer
-                        .UseFixedType<OrderEvent>()))
-                .AddInbound<OrderEvent>(endpoint => endpoint
+                        }))
+
+                // The following configurations is equivalent to the
+                // previous one, but more verbose
+                .AddInbound(endpoint => endpoint
                     .ConsumeFrom("order-events")
                     .Configure(config => 
                         {
                             config.GroupId = "my-consumer";
-                        })));
+                        })
+                    .DeserializeJson(serializer => serializer
+                        .UseFixedType<OrderEvent>())));
 }
 ```
 # [Legacy](#tab/json-fixed-type-legacy)
@@ -111,7 +117,18 @@ public class MyEndpointsConfigurator : IEndpointsConfigurator
                         {
                             config.GroupId = "my-consumer";
                         })
-                    .DeserializeJsonUsingNewtonsoft()));
+                    .DeserializeJsonUsingNewtonsoft())
+
+                // Specifying the message type will automatically
+                // switch to the NewtonsoftJsonMessageSerializer<TMessage>
+                .AddInbound<DeliveryNotification>(endpoint => endpoint
+                    .ConsumeFrom("delivery-notification-events")
+                    .Configure(config => 
+                        {
+                            config.GroupId = "my-consumer";
+                        })
+                    .DeserializeJsonUsingNewtonsoft())
+                    );
 }
 ```
 # [Legacy](#tab/newtonsoft-legacy)