Adds xml docs for HttpSys (#235)

* Adds xml docs for the HttpSys extension.

* Adds a space after xml doc line starters `///`.

Author: ChrSteinert

src/Saturn.Extensions.Authorization/OAuth.fs

@@ -18,9 +18,9 @@ open Newtonsoft.Json.Linq
 let private addCookie state (c : AuthenticationBuilder) = if not state.CookiesAlreadyAdded then c.AddCookie() |> ignore
 
 type Saturn.Application.ApplicationBuilder with
-    ///Enables default Google OAuth authentication.
-    ///`jsonToClaimMap` should contain sequance of tuples where first element is a name of the of the key in JSON object and second element is a name of the claim.
-    ///For example: `["id", ClaimTypes.NameIdentifier; "displayName", ClaimTypes.Name]` where `id` and `displayName` are names of fields in the Google JSON response (https://developers.google.com/+/web/api/rest/latest/people#resource).
+    /// Enables default Google OAuth authentication.
+    /// `jsonToClaimMap` should contain sequance of tuples where first element is a name of the of the key in JSON object and second element is a name of the claim.
+    /// For example: `["id", ClaimTypes.NameIdentifier; "displayName", ClaimTypes.Name]` where `id` and `displayName` are names of fields in the Google JSON response (https://developers.google.com/+/web/api/rest/latest/people#resource).
     [<CustomOperation("use_google_oauth")>]
     member __.UseGoogleAuth(state: ApplicationState, clientId : string, clientSecret : string, callbackPath : string, jsonToClaimMap : (string * string) seq) =
       let middleware (app : IApplicationBuilder) =
@@ -51,7 +51,7 @@ type Saturn.Application.ApplicationBuilder with
           CookiesAlreadyAdded = true
       }
 
-    ///Enables Google OAuth authentication with custom configuration
+    /// Enables Google OAuth authentication with custom configuration
     [<CustomOperation("use_google_oauth_with_config")>]
     member __.UseGoogleAuthWithConfig(state: ApplicationState, (config : Authentication.Google.GoogleOptions -> unit) ) =
       let middleware (app : IApplicationBuilder) =
@@ -72,9 +72,9 @@ type Saturn.Application.ApplicationBuilder with
           CookiesAlreadyAdded = true
       }
 
-    ///Enables default GitHub OAuth authentication.
-    ///`jsonToClaimMap` should contain sequance of tuples where first element is a name of the of the key in JSON object and second element is a name of the claim.
-    ///For example: `["login", "githubUsername"; "name", "fullName"]` where `login` and `name` are names of fields in GitHub JSON response (https://developer.github.com/v3/users/#get-the-authenticated-user).
+    /// Enables default GitHub OAuth authentication.
+    /// `jsonToClaimMap` should contain sequance of tuples where first element is a name of the of the key in JSON object and second element is a name of the claim.
+    /// For example: `["login", "githubUsername"; "name", "fullName"]` where `login` and `name` are names of fields in GitHub JSON response (https://developer.github.com/v3/users/#get-the-authenticated-user).
     [<CustomOperation("use_github_oauth")>]
     member __.UseGithubAuth(state: ApplicationState, clientId : string, clientSecret : string, callbackPath : string, jsonToClaimMap : (string * string) seq) =
       let middleware (app : IApplicationBuilder) =
@@ -107,7 +107,7 @@ type Saturn.Application.ApplicationBuilder with
           CookiesAlreadyAdded = true
       }
 
-    ///Enables GitHub OAuth authentication with custom configuration
+    /// Enables GitHub OAuth authentication with custom configuration
     [<CustomOperation("use_github_oauth_with_config")>]
     member __.UseGithubAuthWithConfig(state: ApplicationState, (config : Authentication.OAuth.OAuthOptions -> unit) ) =
       let middleware (app : IApplicationBuilder) =
@@ -128,10 +128,10 @@ type Saturn.Application.ApplicationBuilder with
           CookiesAlreadyAdded = true
       }
 
-    ///Enalbes default Azure AD OAuth authentication.
-    ///`scopes` must be at least on of the scopes defined in https://docs.microsoft.com/en-us/graph/permissions-reference, for instance "User.Read".
-    ///`jsonToClaimMap` should contain sequance of tuples where first element is a name of the of the key in JSON object and second element is a name of the claim.
-    ///For example: `["name", "http://schemas.xmlsoap.org/ws/2005/05/identity/claims/name" ]` where `name` is the names of a field in Azure AD's JSON response (see https://docs.microsoft.com/en-us/azure/active-directory/develop/id-tokens or inspect tokens with https://jwt.ms).
+    /// Enalbes default Azure AD OAuth authentication.
+    /// `scopes` must be at least on of the scopes defined in https://docs.microsoft.com/en-us/graph/permissions-reference, for instance "User.Read".
+    /// `jsonToClaimMap` should contain sequance of tuples where first element is a name of the of the key in JSON object and second element is a name of the claim.
+    /// For example: `["name", "http://schemas.xmlsoap.org/ws/2005/05/identity/claims/name" ]` where `name` is the names of a field in Azure AD's JSON response (see https://docs.microsoft.com/en-us/azure/active-directory/develop/id-tokens or inspect tokens with https://jwt.ms).
     [<CustomOperation("use_azuread_oauth")>]
     member __.UseAzureADAuth(state: ApplicationState, tenantId : string, clientId : string, clientSecret: string, callbackPath : string, scopes : string seq, jsonToClaimMap : (string * string) seq) =
       let middleware (app : IApplicationBuilder) =
@@ -165,7 +165,7 @@ type Saturn.Application.ApplicationBuilder with
           CookiesAlreadyAdded = true
       }
 
-    ///Enables AzureAD OAuth authentication with custom configuration
+    /// Enables AzureAD OAuth authentication with custom configuration
     [<CustomOperation("use_azuread_oauth_with_config")>]
     member __.UseAzureADAuthWithConfig(state: ApplicationState, (config : Authentication.OAuth.OAuthOptions -> unit) ) =
       let middleware (app : IApplicationBuilder) =

src/Saturn.Extensions.HttpSys/Saturn.HttpSys.fs

@@ -7,6 +7,9 @@ open Microsoft.AspNetCore.Server.HttpSys
 
 type Saturn.Application.ApplicationBuilder with
 
+    /// HTTP.sys is a web server for ASP.NET Core that only runs on Windows. HTTP.sys is an alternative to Kestrel server and offers some features that Kestrel doesn't provide.
+    /// (https://docs.microsoft.com/en-us/aspnet/core/fundamentals/servers/httpsys)
+    /// This operation switches hosting to the HTTP.sys server.
     [<CustomOperation("use_httpsys")>]
     member __.UseHttpSys(state) =
         let host (builder: IWebHostBuilder) =
@@ -15,6 +18,9 @@ type Saturn.Application.ApplicationBuilder with
             HostConfigs = host::state.HostConfigs
         }
 
+    /// HTTP.sys is a web server for ASP.NET Core that only runs on Windows. HTTP.sys is an alternative to Kestrel server and offers some features that Kestrel doesn't provide.
+    /// (https://docs.microsoft.com/en-us/aspnet/core/fundamentals/servers/httpsys)
+    /// This operation switches hosting to the HTTP.sys server and takes additional config.
     [<CustomOperation("use_httpsys_with_config")>]
     member __.UseHttpSysWithConfig(state, config) =
         let host (builder: IWebHostBuilder) =
@@ -23,6 +29,9 @@ type Saturn.Application.ApplicationBuilder with
             HostConfigs = host::state.HostConfigs
         }
 
+    /// HTTP.sys is a web server for ASP.NET Core that only runs on Windows. HTTP.sys is an alternative to Kestrel server and offers some features that Kestrel doesn't provide.
+    /// (https://docs.microsoft.com/en-us/aspnet/core/fundamentals/servers/httpsys)
+    /// This operation switches hosting to the HTTP.sys server and enables Windows Auth (NTLM/Negotiate).
     [<CustomOperation("use_httpsys_windows_auth")>]
     member __.UserHttpSysWindowsAuth(state, allowAnonymous: bool) =
         let host (builder: IWebHostBuilder) =