From a2ff74f8db808c14a40dd5e98c42027320e7d0ef Mon Sep 17 00:00:00 2001
From: Pim Brouwers <pbrouwers@nhlpa.com>
Date: Tue, 12 Dec 2023 06:17:09 -0500
Subject: [PATCH] web_host documentation

---
 docs/docs/host.html   | 26 +++++++++++++++++++++++++-
 documentation/host.md | 27 ++++++++++++++++++++++++++-
 2 files changed, 51 insertions(+), 2 deletions(-)

diff --git a/docs/docs/host.html b/docs/docs/host.html
index 5b74193..3649238 100644
--- a/docs/docs/host.html
+++ b/docs/docs/host.html
@@ -98,6 +98,10 @@ <h2 id="config-logging-other-operations">Config, Logging &amp; Other Operations<
 <td>Configure the host via <code>IHostBuilder</code>.</td>
 </tr>
 <tr>
+<td><a href="#web_host">web_host</a></td>
+<td>Configure the host via <code>IHostBuilder</code>.</td>
+</tr>
+<tr>
 <td><a href="#logging">logging</a></td>
 <td>Configure logging via <code>ILoggingBuilder</code>.</td>
 </tr>
@@ -107,7 +111,7 @@ <h2 id="config-logging-other-operations">Config, Logging &amp; Other Operations<
 </tr>
 </tbody>
 </table>
-<h3 id="logging"><code>logging</code></h3>
+<h3 id="host"><code>host</code></h3>
 <pre><code class="language-fsharp">open Falco
 open Falco.Routing
 open Falco.HostBuilder
@@ -126,6 +130,26 @@ <h3 id="logging"><code>logging</code></h3>
     ]
 }
 </code></pre>
+<h3 id="web_host"><code>web_host</code></h3>
+<pre><code class="language-fsharp">open Falco
+open Falco.Routing
+open Falco.HostBuilder
+open Microsoft.Extensions.Hosting
+open Serilog
+
+let configureWebHost (webHost : IWebHostBuilder) =
+    webHost.UseHttpSys()
+    webHost
+
+webHost [||] {
+    web_host configureWebHost
+
+    endpoints [
+        get &quot;/&quot; (Response.ofPlainText &quot;Hello world&quot;)
+    ]
+}
+</code></pre>
+<h3 id="logging"><code>logging</code></h3>
 <pre><code class="language-fsharp">open Falco
 open Falco.Routing
 open Falco.HostBuilder
diff --git a/documentation/host.md b/documentation/host.md
index 16f141b..63df7a0 100644
--- a/documentation/host.md
+++ b/documentation/host.md
@@ -7,10 +7,11 @@ The `webHost[||] { ... }` computation aims to provide a consistent methodology f
 | Operation | Description |
 | --------- | ----------- |
 | [host](#host) | Configure the host via `IHostBuilder`. |
+| [web_host](#web_host) | Configure the host via `IHostBuilder`. |
 | [logging](#logging) | Configure logging via `ILoggingBuilder`. |
 | [not_found](#not_found) | Include a catch-all (i.e., Not Found) HttpHandler (must be added last). |
 
-### `logging`
+### `host`
 
 ```fsharp
 open Falco
@@ -32,6 +33,30 @@ webHost [||] {
 }
 ```
 
+### `web_host`
+
+```fsharp
+open Falco
+open Falco.Routing
+open Falco.HostBuilder
+open Microsoft.Extensions.Hosting
+open Serilog
+
+let configureWebHost (webHost : IWebHostBuilder) =
+    webHost.UseHttpSys()
+    webHost
+
+webHost [||] {
+    web_host configureWebHost
+
+    endpoints [
+        get "/" (Response.ofPlainText "Hello world")
+    ]
+}
+```
+
+### `logging`
+
 ```fsharp
 open Falco
 open Falco.Routing