Documentation updates

src/client/Microsoft.Identity.Client/Account.cs

@@ -1,7 +1,6 @@
 // Copyright (c) Microsoft Corporation. All rights reserved.
 // Licensed under the MIT License.
 
-using System;
 using System.Collections.Generic;
 using System.Globalization;
 

src/client/Microsoft.Identity.Client/AccountExtensions.cs

@@ -1,11 +1,7 @@
 // Copyright (c) Microsoft Corporation. All rights reserved.
 // Licensed under the MIT License.
 
-using System;
 using System.Collections.Generic;
-using System.Linq;
-using System.Text;
-using System.Threading.Tasks;
 
 namespace Microsoft.Identity.Client
 {

src/client/Microsoft.Identity.Client/ApiConfig/AbstractAcquireTokenParameterBuilder.cs

@@ -16,7 +16,7 @@
 
 namespace Microsoft.Identity.Client
 {
-    /// <inheritdoc />
+    /// <inheritdoc/>
     /// <typeparam name="T"></typeparam>
     public abstract class AbstractAcquireTokenParameterBuilder<T> : BaseAbstractAcquireTokenParameterBuilder<T>
         where T : BaseAbstractAcquireTokenParameterBuilder<T>

src/client/Microsoft.Identity.Client/ApiConfig/AbstractClientAppBaseAcquireTokenParameterBuilder.cs

@@ -26,7 +26,7 @@ internal AbstractClientAppBaseAcquireTokenParameterBuilder(IClientApplicationBas
 
         internal abstract Task<AuthenticationResult> ExecuteInternalAsync(CancellationToken cancellationToken);
 
-        /// <inheritdoc />
+        /// <inheritdoc/>
         public override Task<AuthenticationResult> ExecuteAsync(CancellationToken cancellationToken)
         {
             ValidateAndCalculateApiId();

src/client/Microsoft.Identity.Client/ApiConfig/AbstractConfidentialClientAcquireTokenParameterBuilder.cs

@@ -31,7 +31,7 @@ internal AbstractConfidentialClientAcquireTokenParameterBuilder(IConfidentialCli
 
         internal abstract Task<AuthenticationResult> ExecuteInternalAsync(CancellationToken cancellationToken);
 
-        /// <inheritdoc />
+        /// <inheritdoc/>
         public override Task<AuthenticationResult> ExecuteAsync(CancellationToken cancellationToken)
         {
             ClientApplicationBase.GuardMobileFrameworks();

src/client/Microsoft.Identity.Client/ApiConfig/AbstractManagedIdentityAcquireTokenParameterBuilder.cs

@@ -42,7 +42,7 @@ internal AbstractManagedIdentityAcquireTokenParameterBuilder(IManagedIdentityApp
 
         internal abstract Task<AuthenticationResult> ExecuteInternalAsync(CancellationToken cancellationToken);
 
-        /// <inheritdoc />
+        /// <inheritdoc/>
         public override Task<AuthenticationResult> ExecuteAsync(CancellationToken cancellationToken)
         {
             ApplicationBase.GuardMobileFrameworks();

src/client/Microsoft.Identity.Client/ApiConfig/AbstractPublicClientAcquireTokenParameterBuilder.cs

@@ -27,7 +27,7 @@ internal AbstractPublicClientAcquireTokenParameterBuilder(IPublicClientApplicati
 
         internal abstract Task<AuthenticationResult> ExecuteInternalAsync(CancellationToken cancellationToken);
 
-        /// <inheritdoc />
+        /// <inheritdoc/>
         public override Task<AuthenticationResult> ExecuteAsync(CancellationToken cancellationToken)
         {
             ValidateAndCalculateApiId();

src/client/Microsoft.Identity.Client/ApiConfig/AcquireTokenByAuthorizationCodeParameterBuilder.cs

@@ -49,13 +49,13 @@ private AcquireTokenByAuthorizationCodeParameterBuilder WithAuthorizationCode(st
             return this;
         }
 
-        /// <inheritdoc />
+        /// <inheritdoc/>
         internal override ApiEvent.ApiIds CalculateApiEventId()
         {
             return ApiEvent.ApiIds.AcquireTokenByAuthorizationCode;
         }
 
-        /// <inheritdoc />
+        /// <inheritdoc/>
         protected override void Validate()
         {
             base.Validate();
@@ -71,7 +71,7 @@ protected override void Validate()
             }
         }
 
-        /// <inheritdoc />
+        /// <inheritdoc/>
         internal override Task<AuthenticationResult> ExecuteInternalAsync(CancellationToken cancellationToken)
         {
             return ConfidentialClientApplicationExecutor.ExecuteAsync(CommonParameters, Parameters, cancellationToken);

src/client/Microsoft.Identity.Client/ApiConfig/AcquireTokenByIntegratedWindowsAuthParameterBuilder.cs

@@ -18,7 +18,7 @@ public sealed class AcquireTokenByIntegratedWindowsAuthParameterBuilder :
     {
         private AcquireTokenByIntegratedWindowsAuthParameters Parameters { get; } = new AcquireTokenByIntegratedWindowsAuthParameters();
 
-        /// <inheritdoc />
+        /// <inheritdoc/>
         internal AcquireTokenByIntegratedWindowsAuthParameterBuilder(IPublicClientApplicationExecutor publicClientApplicationExecutor)
             : base(publicClientApplicationExecutor)
         {
@@ -60,7 +60,7 @@ internal override Task<AuthenticationResult> ExecuteInternalAsync(CancellationTo
             return PublicClientApplicationExecutor.ExecuteAsync(CommonParameters, Parameters, cancellationToken);
         }
 
-        /// <inheritdoc />
+        /// <inheritdoc/>
         internal override ApiEvent.ApiIds CalculateApiEventId()
         {
             return ApiEvent.ApiIds.AcquireTokenByIntegratedWindowsAuth;

src/client/Microsoft.Identity.Client/ApiConfig/AcquireTokenByRefreshTokenParameterBuilder.cs

@@ -19,7 +19,7 @@ public sealed class AcquireTokenByRefreshTokenParameterBuilder :
     {
         private AcquireTokenByRefreshTokenParameters Parameters { get; } = new AcquireTokenByRefreshTokenParameters();
 
-        /// <inheritdoc />
+        /// <inheritdoc/>
         internal AcquireTokenByRefreshTokenParameterBuilder(IClientApplicationBaseExecutor clientApplicationBaseExecutor)
             : base(clientApplicationBaseExecutor)
         {
@@ -40,7 +40,7 @@ internal AcquireTokenByRefreshTokenParameterBuilder WithRefreshToken(string refr
             return this;
         }
 
-        /// <inheritdoc />
+        /// <inheritdoc/>
         internal override Task<AuthenticationResult> ExecuteInternalAsync(CancellationToken cancellationToken)
         {
             return ClientApplicationBaseExecutor.ExecuteAsync(CommonParameters, Parameters, cancellationToken);
@@ -56,7 +56,7 @@ protected override void Validate()
             }
         }
 
-        /// <inheritdoc />
+        /// <inheritdoc/>
         internal override ApiEvent.ApiIds CalculateApiEventId()
         {
             return ApiEvent.ApiIds.AcquireTokenByRefreshToken;

src/client/Microsoft.Identity.Client/ApiConfig/AcquireTokenByUsernamePasswordParameterBuilder.cs

@@ -119,13 +119,13 @@ private AcquireTokenByUsernamePasswordParameterBuilder WithPassword(string passw
             return this;
         }
 
-        /// <inheritdoc />
+        /// <inheritdoc/>
         internal override Task<AuthenticationResult> ExecuteInternalAsync(CancellationToken cancellationToken)
         {
             return PublicClientApplicationExecutor.ExecuteAsync(CommonParameters, Parameters, cancellationToken);
         }
 
-        /// <inheritdoc />
+        /// <inheritdoc/>
         internal override ApiEvent.ApiIds CalculateApiEventId()
         {
             return ApiEvent.ApiIds.AcquireTokenByUsernamePassword;

src/client/Microsoft.Identity.Client/ApiConfig/AcquireTokenForClientParameterBuilder.cs

@@ -25,7 +25,7 @@ public sealed class AcquireTokenForClientParameterBuilder :
     {
         private AcquireTokenForClientParameters Parameters { get; } = new AcquireTokenForClientParameters();
 
-        /// <inheritdoc />
+        /// <inheritdoc/>
         internal AcquireTokenForClientParameterBuilder(IConfidentialClientApplicationExecutor confidentialClientApplicationExecutor)
             : base(confidentialClientApplicationExecutor)
         {
@@ -90,7 +90,7 @@ public AcquireTokenForClientParameterBuilder WithPreferredAzureRegion(bool useAz
             throw new NotImplementedException();
         }
 
-        /// <inheritdoc />
+        /// <inheritdoc/>
         internal override Task<AuthenticationResult> ExecuteInternalAsync(CancellationToken cancellationToken)
         {
             return ConfidentialClientApplicationExecutor.ExecuteAsync(CommonParameters, Parameters, cancellationToken);
@@ -106,7 +106,7 @@ protected override void Validate()
             }
         }
 
-        /// <inheritdoc />
+        /// <inheritdoc/>
         internal override ApiEvent.ApiIds CalculateApiEventId()
         {
             return ApiEvent.ApiIds.AcquireTokenForClient;

src/client/Microsoft.Identity.Client/ApiConfig/AcquireTokenForManagedIdentityParameterBuilder.cs

@@ -25,7 +25,7 @@ public sealed class AcquireTokenForManagedIdentityParameterBuilder :
     {
         private AcquireTokenForManagedIdentityParameters Parameters { get; } = new AcquireTokenForManagedIdentityParameters();
 
-        /// <inheritdoc />
+        /// <inheritdoc/>
         internal AcquireTokenForManagedIdentityParameterBuilder(IManagedIdentityApplicationExecutor managedIdentityApplicationExecutor)
             : base(managedIdentityApplicationExecutor)
         {
@@ -59,13 +59,13 @@ public AcquireTokenForManagedIdentityParameterBuilder WithForceRefresh(bool forc
             return this;
         }
 
-        /// <inheritdoc />
+        /// <inheritdoc/>
         internal override Task<AuthenticationResult> ExecuteInternalAsync(CancellationToken cancellationToken)
         {
             return ManagedIdentityApplicationExecutor.ExecuteAsync(CommonParameters, Parameters, cancellationToken);
         }
 
-        /// <inheritdoc />
+        /// <inheritdoc/>
         internal override ApiEvent.ApiIds CalculateApiEventId()
         {
             if (ServiceBundle.Config.ManagedIdentityId.IdType == AppConfig.ManagedIdentityIdType.SystemAssigned)

src/client/Microsoft.Identity.Client/ApiConfig/AcquireTokenInteractiveParameterBuilder.cs

@@ -388,7 +388,7 @@ public AcquireTokenInteractiveParameterBuilder WithProofOfPossession(string nonc
             return this;
         }
 
-        /// <inheritdoc />
+        /// <inheritdoc/>
         protected override void Validate()
         {
             base.Validate();
@@ -417,7 +417,7 @@ protected override void Validate()
                                           : Parameters.LoginHint;
         }
 
-        /// <inheritdoc />
+        /// <inheritdoc/>
         internal override Task<AuthenticationResult> ExecuteInternalAsync(CancellationToken cancellationToken)
         {
             return PublicClientApplicationExecutor.ExecuteAsync(CommonParameters, Parameters, cancellationToken);

src/client/Microsoft.Identity.Client/ApiConfig/AcquireTokenOnBehalfOfParameterBuilder.cs

@@ -26,7 +26,7 @@ public sealed class AcquireTokenOnBehalfOfParameterBuilder :
     {
         internal AcquireTokenOnBehalfOfParameters Parameters { get; } = new AcquireTokenOnBehalfOfParameters();
 
-        /// <inheritdoc />
+        /// <inheritdoc/>
         internal AcquireTokenOnBehalfOfParameterBuilder(IConfidentialClientApplicationExecutor confidentialClientApplicationExecutor)
             : base(confidentialClientApplicationExecutor)
         {
@@ -163,7 +163,7 @@ public AcquireTokenOnBehalfOfParameterBuilder WithCcsRoutingHint(string userName
             return this;
         }
 
-        /// <inheritdoc />
+        /// <inheritdoc/>
         internal override Task<AuthenticationResult> ExecuteInternalAsync(CancellationToken cancellationToken)
         {
             return ConfidentialClientApplicationExecutor.ExecuteAsync(CommonParameters, Parameters, cancellationToken);
@@ -178,7 +178,7 @@ protected override void Validate()
                 Parameters.SendX5C = this.ServiceBundle.Config?.SendX5C ?? false;
             }
         }
-        /// <inheritdoc />
+        /// <inheritdoc/>
         internal override ApiEvent.ApiIds CalculateApiEventId()
         {
             if (string.IsNullOrEmpty(Parameters.LongRunningOboCacheKey))

src/client/Microsoft.Identity.Client/ApiConfig/AcquireTokenSilentParameterBuilder.cs

@@ -19,7 +19,7 @@
 
 namespace Microsoft.Identity.Client
 {
-    /// <inheritdoc />
+    /// <inheritdoc/>
     /// <summary>
     /// Parameter builder for the <see cref="IClientApplicationBase.AcquireTokenSilent(IEnumerable{string}, IAccount)"/>
     /// operation. See https://aka.ms/msal-net-acquiretokensilent
@@ -88,7 +88,7 @@ public AcquireTokenSilentParameterBuilder WithForceRefresh(bool forceRefresh)
             return this;
         }
 
-        /// <inheritdoc />
+        /// <inheritdoc/>
         internal override Task<AuthenticationResult> ExecuteInternalAsync(CancellationToken cancellationToken)
         {
             return ClientApplicationBaseExecutor.ExecuteAsync(CommonParameters, Parameters, cancellationToken);
@@ -118,7 +118,7 @@ protected override void Validate()
             }
         }
 
-        /// <inheritdoc />
+        /// <inheritdoc/>
         internal override ApiEvent.ApiIds CalculateApiEventId()
         {
             return ApiEvent.ApiIds.AcquireTokenSilent;

src/client/Microsoft.Identity.Client/ApiConfig/AcquireTokenWithDeviceCodeParameterBuilder.cs

@@ -20,7 +20,7 @@ public sealed class AcquireTokenWithDeviceCodeParameterBuilder :
     {
         private AcquireTokenWithDeviceCodeParameters Parameters { get; } = new AcquireTokenWithDeviceCodeParameters();
 
-        /// <inheritdoc />
+        /// <inheritdoc/>
         internal AcquireTokenWithDeviceCodeParameterBuilder(IPublicClientApplicationExecutor publicClientApplicationExecutor)
             : base(publicClientApplicationExecutor)
         {
@@ -49,13 +49,13 @@ public AcquireTokenWithDeviceCodeParameterBuilder WithDeviceCodeResultCallback(
             return this;
         }
 
-        /// <inheritdoc />
+        /// <inheritdoc/>
         internal override Task<AuthenticationResult> ExecuteInternalAsync(CancellationToken cancellationToken)
         {
             return PublicClientApplicationExecutor.ExecuteAsync(CommonParameters, Parameters, cancellationToken);
         }
 
-        /// <inheritdoc />
+        /// <inheritdoc/>
         internal override ApiEvent.ApiIds CalculateApiEventId()
         {
             return ApiEvent.ApiIds.AcquireTokenByDeviceCode;

src/client/Microsoft.Identity.Client/ApiConfig/GetAuthorizationRequestUrlParameterBuilder.cs

@@ -123,7 +123,7 @@ public GetAuthorizationRequestUrlParameterBuilder WithPrompt(Prompt prompt)
             return this;
         }
 
-        /// <inheritdoc />
+        /// <inheritdoc/>
         internal override Task<AuthenticationResult> ExecuteInternalAsync(CancellationToken cancellationToken)
         {
             throw new InvalidOperationException("This is a developer BUG.  This should never get executed.");
@@ -155,7 +155,7 @@ internal override Task<AuthenticationResult> ExecuteInternalAsync(CancellationTo
             return ExecuteAsync(CancellationToken.None);
         }
 
-        /// <inheritdoc />
+        /// <inheritdoc/>
         internal override ApiEvent.ApiIds CalculateApiEventId()
         {
             return ApiEvent.ApiIds.GetAuthorizationRequestUrl;

src/client/Microsoft.Identity.Client/ApiConfig/Parameters/AcquireTokenByIntegratedWindowsAuthParameters.cs

@@ -9,7 +9,7 @@ namespace Microsoft.Identity.Client.ApiConfig.Parameters
     /// </summary>
     internal class AcquireTokenByIntegratedWindowsAuthParameters : AbstractAcquireTokenByUsernameParameters, IAcquireTokenParameters
     {
-        /// <inheritdoc />
+        /// <inheritdoc/>
         public void LogParameters(ILoggerAdapter logger)
         {
         }

src/client/Microsoft.Identity.Client/ApiConfig/Parameters/AcquireTokenByUsernamePasswordParameters.cs

@@ -10,7 +10,7 @@ internal class AcquireTokenByUsernamePasswordParameters : AbstractAcquireTokenBy
     {
         public string Password { get; set; }
 
-        /// <inheritdoc />
+        /// <inheritdoc/>
         public void LogParameters(ILoggerAdapter logger)
         {
         }

src/client/Microsoft.Identity.Client/ApiConfig/Parameters/AcquireTokenForClientParameters.cs

@@ -12,7 +12,7 @@ internal class AcquireTokenForClientParameters : AbstractAcquireTokenConfidentia
         /// </summary>
         public bool ForceRefresh { get; set; }
 
-        /// <inheritdoc />
+        /// <inheritdoc/>
         public void LogParameters(ILoggerAdapter logger)
         {
             if (logger.IsLoggingEnabled(LogLevel.Info))

src/client/Microsoft.Identity.Client/ApiConfig/Parameters/AcquireTokenOnBehalfOfParameters.cs

@@ -28,7 +28,7 @@ internal class AcquireTokenOnBehalfOfParameters : AbstractAcquireTokenConfidenti
 
         public bool ForceRefresh { get; set; }
 
-        /// <inheritdoc />
+        /// <inheritdoc/>
         public void LogParameters(ILoggerAdapter logger)
         {
             if (logger.IsLoggingEnabled(LogLevel.Info))

src/client/Microsoft.Identity.Client/ApiConfig/Parameters/AcquireTokenSilentParameters.cs

@@ -12,7 +12,7 @@ internal class AcquireTokenSilentParameters : IAcquireTokenParameters
         public IAccount Account { get; set; }
         public bool? SendX5C { get; set; }
 
-        /// <inheritdoc />
+        /// <inheritdoc/>
         public void LogParameters(ILoggerAdapter logger)
         {
             if (logger.IsLoggingEnabled(LogLevel.Info))

src/client/Microsoft.Identity.Client/ApiConfig/Parameters/AcquireTokenWithDeviceCodeParameters.cs

@@ -11,7 +11,7 @@ internal class AcquireTokenWithDeviceCodeParameters : IAcquireTokenParameters
     {
         public Func<DeviceCodeResult, Task> DeviceCodeResultCallback { get; set; }
 
-        /// <inheritdoc />
+        /// <inheritdoc/>
         public void LogParameters(ILoggerAdapter logger)
         {
         }

src/client/Microsoft.Identity.Client/ApiConfig/Parameters/GetAuthorizationRequestUrlParameters.cs

@@ -30,7 +30,7 @@ public AcquireTokenInteractiveParameters ToInteractiveParameters()
             };
         }
 
-        /// <inheritdoc />
+        /// <inheritdoc/>
         public void LogParameters(ILoggerAdapter logger)
         {
         }

src/client/Microsoft.Identity.Client/AppConfig/ConfidentialClientApplicationBuilder.cs

@@ -25,7 +25,7 @@ namespace Microsoft.Identity.Client
 #endif
     public class ConfidentialClientApplicationBuilder : AbstractApplicationBuilder<ConfidentialClientApplicationBuilder>
     {
-        /// <inheritdoc />
+        /// <inheritdoc/>
         internal ConfidentialClientApplicationBuilder(ApplicationConfiguration configuration)
             : base(configuration)
         {
@@ -384,7 +384,7 @@ internal ConfidentialClientApplicationBuilder WithAppTokenCacheInternalForTest(I
             return this;
         }
 
-        /// <inheritdoc />
+        /// <inheritdoc/>
         internal override void Validate()
         {
             base.Validate();