From b6ad0a704c4b90b8030174646ee1e11d898ac87b Mon Sep 17 00:00:00 2001
From: Chris Ross <chrross@microsoft.com>
Date: Thu, 9 Sep 2021 21:37:35 -0700
Subject: [PATCH] Doc kestrel config reload support (#23256)

---
 .../fundamentals/servers/kestrel/endpoints.md       | 13 +++++++++++--
 1 file changed, 11 insertions(+), 2 deletions(-)

diff --git a/aspnetcore/fundamentals/servers/kestrel/endpoints.md b/aspnetcore/fundamentals/servers/kestrel/endpoints.md
index fc13a6146b..b46e2a01a5 100644
--- a/aspnetcore/fundamentals/servers/kestrel/endpoints.md
+++ b/aspnetcore/fundamentals/servers/kestrel/endpoints.md
@@ -62,9 +62,11 @@ webBuilder.ConfigureKestrel(serverOptions =>
 
 ## Configure(IConfiguration)
 
-Creates a configuration loader for setting up Kestrel that takes an <xref:Microsoft.Extensions.Configuration.IConfiguration> as input. The configuration must be scoped to the configuration section for Kestrel.
+Enables Kestrel to load endpoints from an <xref:Microsoft.Extensions.Configuration.IConfiguration>. The configuration must be scoped to the configuration section for Kestrel.
 
-`CreateDefaultBuilder` calls `Configure(context.Configuration.GetSection("Kestrel"))` by default to load Kestrel configuration.
+The `Configure(IConfiguration, bool)` overload can be used to enable reloading endpoints when the configuration source changes.
+
+`IHostBuilder.ConfigureWebHostDefaults` calls `Configure(context.Configuration.GetSection("Kestrel"), reloadOnChange: true)` by default to load Kestrel configuration and enable reloading.
 
 ```json
 {
@@ -85,6 +87,13 @@ Creates a configuration loader for setting up Kestrel that takes an <xref:Micros
 }
 ```
 
+If reloading configuration is enabled and a change is signaled then the following steps are taken:
+- The new configuraiton is compared to the old one, any endpoint without configuration changes are not modified.
+- Removed or modified endpoints are given 5 seconds to complete processing requests and shut down.
+- New or modified endpoints are started.
+
+Clients connecting to a modified endpoint may be disconnected or refused while the endpoint is restarted.
+
 ## ConfigureHttpsDefaults(Action\<HttpsConnectionAdapterOptions>)
 
 Specifies a configuration `Action` to run for each HTTPS endpoint. Calling `ConfigureHttpsDefaults` multiple times replaces prior `Action`s with the last `Action` specified.