very basic docs on the new HTTP transport

Author: jeremydmiller

docs/.vitepress/config.mts

@@ -227,7 +227,8 @@ const config: UserConfig<DefaultTheme.Config> = {
                         {text: 'Validation', link: '/guide/http/validation'},
                         {text: 'Fluent Validation', link: '/guide/http/fluentvalidation'},
                         {text: 'Problem Details', link: '/guide/http/problemdetails'},
-                        {text: 'Caching', link: '/guide/http/caching'}
+                        {text: 'Caching', link: '/guide/http/caching'},
+                        {text: 'HTTP Messaging Transport', link: '/guide/http/transport'}
                     ]
                 },
                 {

docs/guide/http/mediator.md

@@ -45,7 +45,7 @@ The functionality is used from extension methods off of the ASP.Net Core [WebApp
         app.MapDeleteToWolverine<CustomRequest, CustomResponse>("/wolverine/request");
         app.MapPutToWolverine<CustomRequest, CustomResponse>("/wolverine/request");
 ```
-<sup><a href='https://github.com/JasperFx/wolverine/blob/main/src/Http/WolverineWebApi/Program.cs#L290-L302' title='Snippet source file'>snippet source</a> | <a href='#snippet-sample_optimized_mediator_usage' title='Start of snippet'>anchor</a></sup>
+<sup><a href='https://github.com/JasperFx/wolverine/blob/main/src/Http/WolverineWebApi/Program.cs#L294-L306' title='Snippet source file'>snippet source</a> | <a href='#snippet-sample_optimized_mediator_usage' title='Start of snippet'>anchor</a></sup>
 <!-- endSnippet -->
 
 With this mechanism, Wolverine is able to optimize the runtime function for Minimal API by eliminating IoC service locations

docs/guide/http/transport.md

@@ -0,0 +1,37 @@
+# HTTP Messaging Transport
+
+On top of everything else that Wolverine does, the `WolverineFx.HTTP` Nuget also contains the ability to use HTTP as a
+messaging transport for Wolverine messaging. Assuming you have that library attached to your AspNetCore project, add
+this declaration to your `WebApplication` in your `Program.Main()` method:
+
+<!-- snippet: sample_MapWolverineHttpTransportEndpoints -->
+<a id='snippet-sample_mapwolverinehttptransportendpoints'></a>
+```cs
+app.MapWolverineHttpTransportEndpoints();
+```
+<sup><a href='https://github.com/JasperFx/wolverine/blob/main/src/Http/WolverineWebApi/Program.cs#L288-L292' title='Snippet source file'>snippet source</a> | <a href='#snippet-sample_mapwolverinehttptransportendpoints' title='Start of snippet'>anchor</a></sup>
+<!-- endSnippet -->
+
+The declaration above is actually using Minimal API rather than native Wolverine.HTTP endpoints, but that's perfectly fine 
+in this case. That declaration also enables you to use Minimal API's Fluent Interface to customize the authorization
+rules against the HTTP endpoints for Wolverine messaging. 
+
+To establish publishing rules in your application to a remote endpoint in another system, use this syntax:
+
+<!-- snippet: sample_publishing_rules_for_http -->
+<a id='snippet-sample_publishing_rules_for_http'></a>
+```cs
+using var host = await Host.CreateDefaultBuilder()
+    .UseWolverine(opts =>
+    {
+        opts.PublishAllMessages()
+            .ToHttpEndpoint("https://binary.com/api");
+    })
+    .StartAsync();
+```
+<sup><a href='https://github.com/JasperFx/wolverine/blob/main/src/Http/Wolverine.Http.Tests/Transport/HttpTransportConfigurationTests.cs#L100-L110' title='Snippet source file'>snippet source</a> | <a href='#snippet-sample_publishing_rules_for_http' title='Start of snippet'>anchor</a></sup>
+<!-- endSnippet -->
+
+::: tip
+This functionality if very new, and you may want to reach out through Discord for any questions. 
+:::

src/Http/Wolverine.Http.Tests/Transport/HttpTransportConfigurationTests.cs

@@ -97,6 +97,8 @@ public async Task to_http_endpoint_with_cloud_events_sets_serializer_options()
     [Fact]
     public async Task to_http_endpoint_without_cloud_events_keeps_default_options()
     {
+        #region sample_publishing_rules_for_http
+
         using var host = await Host.CreateDefaultBuilder()
             .UseWolverine(opts =>
             {
@@ -105,6 +107,8 @@ public async Task to_http_endpoint_without_cloud_events_keeps_default_options()
             })
             .StartAsync();
 
+        #endregion
+
         var runtime = host.GetRuntime();
         var transport = runtime.Options.Transports.GetOrCreate<HttpTransport>();
 

src/Http/WolverineWebApi/Program.cs

@@ -284,9 +284,13 @@ public static async Task<int> Main(string[] args)
 
             #endregion
         });
-        
+
+        #region sample_MapWolverineHttpTransportEndpoints
+
         app.MapWolverineHttpTransportEndpoints();
 
+        #endregion
+
         #region sample_optimized_mediator_usage
 
 // Functional equivalent to MapPost(pattern, (command, IMessageBus) => bus.Invoke(command))