Add missing XML documentation

Author: kevinchalet

src/AspNet.Security.OAuth.Introspection/OAuthIntrospectionExtensions.cs

@@ -13,7 +13,7 @@ namespace Microsoft.AspNetCore.Builder
 {
     /// <summary>
     /// Provides extension methods used to configure the OAuth2
-    /// introspection middleware in an ASP.NET 5 pipeline.
+    /// introspection middleware in an ASP.NET Core pipeline.
     /// </summary>
     public static class OAuthIntrospectionExtensions
     {

src/AspNet.Security.OAuth.Introspection/OAuthIntrospectionHandler.cs

@@ -25,6 +25,9 @@
 
 namespace AspNet.Security.OAuth.Introspection
 {
+    /// <summary>
+    /// Provides the logic necessary to extract and validate tokens from HTTP requests.
+    /// </summary>
     public class OAuthIntrospectionHandler : AuthenticationHandler<OAuthIntrospectionOptions>
     {
         protected override async Task<AuthenticateResult> HandleAuthenticateAsync()

src/AspNet.Security.OAuth.Introspection/OAuthIntrospectionMiddleware.cs

@@ -18,8 +18,15 @@
 
 namespace AspNet.Security.OAuth.Introspection
 {
+    /// <summary>
+    /// Provides the entry point necessary to register the
+    /// OAuth2 introspection handler in an ASP.NET Core pipeline.
+    /// </summary>
     public class OAuthIntrospectionMiddleware : AuthenticationMiddleware<OAuthIntrospectionOptions>
     {
+        /// <summary>
+        /// Creates a new instance of the <see cref="OAuthIntrospectionMiddleware"/> class.
+        /// </summary>
         public OAuthIntrospectionMiddleware(
             [NotNull] RequestDelegate next,
             [NotNull] IOptions<OAuthIntrospectionOptions> options,
@@ -126,6 +133,10 @@ public OAuthIntrospectionMiddleware(
             }
         }
 
+        /// <summary>
+        /// Returns a new <see cref="OAuthIntrospectionHandler"/> instance.
+        /// </summary>
+        /// <returns>A new instance of the <see cref="OAuthIntrospectionHandler"/> class.</returns>
         protected override AuthenticationHandler<OAuthIntrospectionOptions> CreateHandler()
         {
             return new OAuthIntrospectionHandler();

src/AspNet.Security.OAuth.Introspection/OAuthIntrospectionOptions.cs

@@ -16,8 +16,15 @@
 
 namespace AspNet.Security.OAuth.Introspection
 {
+    /// <summary>
+    /// Exposes various settings needed to control
+    /// the behavior of the introspection middleware.
+    /// </summary>
     public class OAuthIntrospectionOptions : AuthenticationOptions
     {
+        /// <summary>
+        /// Creates a new instance of the <see cref="OAuthIntrospectionOptions"/> class.
+        /// </summary>
         public OAuthIntrospectionOptions()
         {
             AuthenticationScheme = OAuthIntrospectionDefaults.AuthenticationScheme;

src/AspNet.Security.OAuth.Validation/OAuthValidationExtensions.cs

@@ -13,7 +13,7 @@ namespace Microsoft.AspNetCore.Builder
 {
     /// <summary>
     /// Provides extension methods used to configure the OAuth2
-    /// validation middleware in an ASP.NET 5 pipeline.
+    /// validation middleware in an ASP.NET Core pipeline.
     /// </summary>
     public static class OAuthValidationExtensions
     {

src/AspNet.Security.OAuth.Validation/OAuthValidationHandler.cs

@@ -18,6 +18,9 @@
 
 namespace AspNet.Security.OAuth.Validation
 {
+    /// <summary>
+    /// Provides the logic necessary to extract and validate tokens from HTTP requests.
+    /// </summary>
     public class OAuthValidationHandler : AuthenticationHandler<OAuthValidationOptions>
     {
         protected override async Task<AuthenticateResult> HandleAuthenticateAsync()

src/AspNet.Security.OAuth.Validation/OAuthValidationMiddleware.cs

@@ -14,8 +14,15 @@
 
 namespace AspNet.Security.OAuth.Validation
 {
+    /// <summary>
+    /// Provides the entry point necessary to register the
+    /// OAuth2 validation handler in an ASP.NET Core pipeline.
+    /// </summary>
     public class OAuthValidationMiddleware : AuthenticationMiddleware<OAuthValidationOptions>
     {
+        /// <summary>
+        /// Creates a new instance of the <see cref="OAuthValidationMiddleware"/> class.
+        /// </summary>
         public OAuthValidationMiddleware(
             [NotNull] RequestDelegate next,
             [NotNull] IOptions<OAuthValidationOptions> options,
@@ -44,6 +51,10 @@ public OAuthValidationMiddleware(
             }
         }
 
+        /// <summary>
+        /// Returns a new <see cref="OAuthValidationHandler"/> instance.
+        /// </summary>
+        /// <returns>A new instance of the <see cref="OAuthValidationHandler"/> class.</returns>
         protected override AuthenticationHandler<OAuthValidationOptions> CreateHandler()
         {
             return new OAuthValidationHandler();

src/AspNet.Security.OAuth.Validation/OAuthValidationOptions.cs

@@ -13,8 +13,15 @@
 
 namespace AspNet.Security.OAuth.Validation
 {
+    /// <summary>
+    /// Exposes various settings needed to control
+    /// the behavior of the validation middleware.
+    /// </summary>
     public class OAuthValidationOptions : AuthenticationOptions
     {
+        /// <summary>
+        /// Creates a new instance of the <see cref="OAuthValidationOptions"/> class.
+        /// </summary>
         public OAuthValidationOptions()
         {
             AuthenticationScheme = OAuthValidationDefaults.AuthenticationScheme;

src/Owin.Security.OAuth.Introspection/OAuthIntrospectionHandler.cs

@@ -22,6 +22,9 @@
 
 namespace Owin.Security.OAuth.Introspection
 {
+    /// <summary>
+    /// Provides the logic necessary to extract and validate tokens from HTTP requests.
+    /// </summary>
     public class OAuthIntrospectionHandler : AuthenticationHandler<OAuthIntrospectionOptions>
     {
         protected override async Task<AuthenticationTicket> AuthenticateCoreAsync()

src/Owin.Security.OAuth.Introspection/OAuthIntrospectionMiddleware.cs

@@ -20,8 +20,15 @@
 
 namespace Owin.Security.OAuth.Introspection
 {
+    /// <summary>
+    /// Provides the entry point necessary to register the
+    /// OAuth2 introspection handler in an OWIN/Katana pipeline.
+    /// </summary>
     public class OAuthIntrospectionMiddleware : AuthenticationMiddleware<OAuthIntrospectionOptions>
     {
+        /// <summary>
+        /// Creates a new instance of the <see cref="OAuthIntrospectionMiddleware"/> class.
+        /// </summary>
         public OAuthIntrospectionMiddleware(
             [NotNull] OwinMiddleware next,
             [NotNull] IDictionary<string, object> properties,
@@ -145,6 +152,10 @@ public OAuthIntrospectionMiddleware(
             }
         }
 
+        /// <summary>
+        /// Returns a new <see cref="OAuthIntrospectionHandler"/> instance.
+        /// </summary>
+        /// <returns>A new instance of the <see cref="OAuthIntrospectionHandler"/> class.</returns>
         protected override AuthenticationHandler<OAuthIntrospectionOptions> CreateHandler()
         {
             return new OAuthIntrospectionHandler();