diff --git a/src/libraries/Microsoft.Extensions.Hosting/src/Host.cs b/src/libraries/Microsoft.Extensions.Hosting/src/Host.cs
index 77d2d58801263..06c9a8fc8ba41 100644
--- a/src/libraries/Microsoft.Extensions.Hosting/src/Host.cs
+++ b/src/libraries/Microsoft.Extensions.Hosting/src/Host.cs
@@ -8,11 +8,49 @@
namespace Microsoft.Extensions.Hosting
{
+ ///
+ /// Provides convenience methods for creating instances of with pre-configured defaults.
+ ///
public static class Host
{
+ ///
+ /// Initializes a new instance of the class with pre-configured defaults.
+ ///
+ ///
+ /// The following defaults are applied to the returned :
+ ///
+ /// - set the to the result of
+ /// - load host from "DOTNET_" prefixed environment variables
+ /// - load app from 'appsettings.json' and 'appsettings.[].json'
+ /// - load app from User Secrets when is 'Development' using the entry assembly
+ /// - load app from environment variables
+ /// - configure the to log to the console, debug, and event source output
+ /// - enables scope validation on the dependency injecton container when is 'Development'
+ ///
+ ///
+ /// The initialized .
public static IHostBuilder CreateDefaultBuilder() =>
CreateDefaultBuilder(args: null);
+ ///
+ /// Initializes a new instance of the class with pre-configured defaults.
+ ///
+ ///
+ /// The following defaults are applied to the returned :
+ ///
+ /// - set the to the result of
+ /// - load host from "DOTNET_" prefixed environment variables
+ /// - load host from supplied command line args
+ /// - load app from 'appsettings.json' and 'appsettings.[].json'
+ /// - load app from User Secrets when is 'Development' using the entry assembly
+ /// - load app from environment variables
+ /// - load app from supplied command line args
+ /// - configure the to log to the console, debug, and event source output
+ /// - enables scope validation on the dependency injecton container when is 'Development'
+ ///
+ ///
+ /// The command line args.
+ /// The initialized .
public static IHostBuilder CreateDefaultBuilder(string[] args)
{
var builder = new HostBuilder();