From de59a61f9a4df32019e1af50b7c070a78e702a28 Mon Sep 17 00:00:00 2001
From: Pranav K <prkrishn@hotmail.com>
Date: Mon, 28 Sep 2020 13:52:04 -0700
Subject: [PATCH] Update GenericHostBuilderExtensions.cs (#26386)

---
 .../src/GenericHostBuilderExtensions.cs       | 25 +++++++++++--------
 1 file changed, 15 insertions(+), 10 deletions(-)

diff --git a/src/DefaultBuilder/src/GenericHostBuilderExtensions.cs b/src/DefaultBuilder/src/GenericHostBuilderExtensions.cs
index 201fb26fe0..ccf7c3821c 100644
--- a/src/DefaultBuilder/src/GenericHostBuilderExtensions.cs
+++ b/src/DefaultBuilder/src/GenericHostBuilderExtensions.cs
@@ -1,3 +1,6 @@
+// Copyright (c) .NET Foundation. All rights reserved.
+// Licensed under the Apache License, Version 2.0. See License.txt in the project root for license information.
+
 using System;
 using Microsoft.AspNetCore.Hosting;
 using Microsoft.AspNetCore;
@@ -5,24 +8,26 @@ using Microsoft.AspNetCore;
 namespace Microsoft.Extensions.Hosting
 {
     /// <summary>
-    /// Extension methods for configuring the IWebHostBuilder.
+    /// Extension methods for configuring the <see cref="IHostBuilder" />.
     /// </summary>
     public static class GenericHostBuilderExtensions
     {
         /// <summary>
-        /// Initializes a new instance of the <see cref="IWebHostBuilder"/> class with pre-configured defaults.
+        /// Configures a <see cref="IHostBuilder" /> with defaults for hosting a web app.
         /// </summary>
         /// <remarks>
-        ///   The following defaults are applied to the <see cref="IWebHostBuilder"/>:
-        ///     use Kestrel as the web server and configure it using the application's configuration providers,
-        ///     configure the <see cref="IWebHostEnvironment.WebRootFileProvider"/> to map static web assets when <see cref="IHostEnvironment.EnvironmentName"/> is 'Development' using the entry assembly,
-        ///     adds the HostFiltering middleware,
-        ///     adds the ForwardedHeaders middleware if ASPNETCORE_FORWARDEDHEADERS_ENABLED=true,
-        ///     and enable IIS integration.
+        /// The following defaults are applied to the <see cref="IHostBuilder"/>:
+        /// <list type="bullet">
+        ///     <item><description>use Kestrel as the web server and configure it using the application's configuration providers</description></item>
+        ///     <item><description>configure <see cref="IWebHostEnvironment.WebRootFileProvider"/> to include static web assets from projects referenced by the entry assembly during development</description></item>        
+        ///     <item><description>adds the HostFiltering middleware</description></item>
+        ///     <item><description>adds the ForwardedHeaders middleware if ASPNETCORE_FORWARDEDHEADERS_ENABLED=true,</description></item>
+        ///     <item><description>enable IIS integration</description></item>
+        ///   </list>
         /// </remarks>
-        /// <param name="builder">The <see cref="IHostBuilder" /> instance to configure</param>
+        /// <param name="builder">The <see cref="IHostBuilder" /> instance to configure.</param>
         /// <param name="configure">The configure callback</param>
-        /// <returns>The <see cref="IHostBuilder"/> for chaining.</returns>
+        /// <returns>A reference to the <paramref name="builder"/> after the operation has completed.</returns>
         public static IHostBuilder ConfigureWebHostDefaults(this IHostBuilder builder, Action<IWebHostBuilder> configure)
         {
             if (configure is null)