PR feedback round 2

Author: sgonzalezMSFT

src/main/java/com/microsoft/aad/msal4j/DeviceCode.java

@@ -18,7 +18,7 @@
 public final class DeviceCode {
 
     /**
-     * code which user needs to provide when authenticating at he verification URI
+     * code which user needs to provide when authenticating at the verification URI
      */
     @SerializedName("user_code")
     private String userCode;

src/main/java/com/microsoft/aad/msal4j/IConfidentialClientApplication.java

@@ -15,7 +15,7 @@ public interface IConfidentialClientApplication extends IClientApplicationBase {
 
     /**
      * Acquires tokens from the authority configured in the application, for the confidential client
-     * itself (in the name of no user)
+     * itself
      * @param parameters instance of {@link ClientCredentialParameters}
      * @return {@link CompletableFuture} containing an {@link IAuthenticationResult}
      */

src/main/java/com/microsoft/aad/msal4j/ITokenCacheAccessContext.java

@@ -4,7 +4,7 @@
 package com.microsoft.aad.msal4j;
 
 /**
- * Interface representing state of token cache
+ * Interface representing context in which the token cache is accessed
  */
 public interface ITokenCacheAccessContext {
 

src/main/java/com/microsoft/aad/msal4j/IUserAssertion.java

@@ -4,7 +4,7 @@
 package com.microsoft.aad.msal4j;
 
 /**
- * Interface representing user credential used by downstream application in On-Behalf-Of flow
+ * Interface representing a delegated user identity used by downstream applications in On-Behalf-Of flow
  */
 public interface IUserAssertion {
 

src/main/java/com/microsoft/aad/msal4j/TokenCacheAccessContext.java

@@ -8,7 +8,7 @@
 import lombok.experimental.Accessors;
 
 /**
- * State of token cache
+ * Context in which the the token cache is accessed
  */
 @Builder
 @Accessors(fluent = true)

src/main/java/com/microsoft/aad/msal4j/UserAssertion.java

@@ -4,8 +4,8 @@
 package com.microsoft.aad.msal4j;
 
 /***
- * Credential type containing an assertion representing user credential. Used as a parameter in
- * {@link OnBehalfOfParameters}
+ * Credential type containing an assertion representing a delegated user identity.
+ * Used as a parameter in {@link OnBehalfOfParameters}
  */
 public class UserAssertion implements IUserAssertion {