diff --git a/src/Microsoft.AspNetCore.Mvc.Core/DependencyInjection/MvcCoreServiceCollectionExtensions.cs b/src/Microsoft.AspNetCore.Mvc.Core/DependencyInjection/MvcCoreServiceCollectionExtensions.cs
index 23103c6ee1..d168060524 100644
--- a/src/Microsoft.AspNetCore.Mvc.Core/DependencyInjection/MvcCoreServiceCollectionExtensions.cs
+++ b/src/Microsoft.AspNetCore.Mvc.Core/DependencyInjection/MvcCoreServiceCollectionExtensions.cs
@@ -30,10 +30,21 @@ namespace Microsoft.Extensions.DependencyInjection
public static class MvcCoreServiceCollectionExtensions
{
///
- /// Adds essential MVC services to the specified .
+ /// Adds the minimum essential MVC services to the specified . Addtional services
+ /// including MVC's support for authorization, formatters, and validation must be added separately using the
+ /// returned from this method.
///
/// The to add services to.
/// An that can be used to further configure the MVC services.
+ ///
+ /// The approach for configuring
+ /// MVC is provided for experienced MVC developers who wish to have full control over the set of default services
+ /// registered. will register
+ /// the minimum set of services necessary to route requests and invoke controllers. It is not expected that any
+ /// application will satisfy its requirements with just a call to
+ /// . Additional configuration using the
+ /// will be required.
+ ///
public static IMvcCoreBuilder AddMvcCore(this IServiceCollection services)
{
if (services == null)
@@ -92,11 +103,22 @@ namespace Microsoft.Extensions.DependencyInjection
}
///
- /// Adds essential MVC services to the specified .
+ /// Adds the minimum essential MVC services to the specified . Addtional services
+ /// including MVC's support for authorization, formatters, and validation must be added separately using the
+ /// returned from this method.
///
/// The to add services to.
/// An to configure the provided .
/// An that can be used to further configure the MVC services.
+ ///
+ /// The approach for configuring
+ /// MVC is provided for experienced MVC developers who wish to have full control over the set of default services
+ /// registered. will register
+ /// the minimum set of services necessary to route requests and invoke controllers. It is not expected that any
+ /// application will satisfy its requirements with just a call to
+ /// . Additional configuration using the
+ /// will be required.
+ ///
public static IMvcCoreBuilder AddMvcCore(
this IServiceCollection services,
Action setupAction)