Auth Javadoc edits (#540)

* Javadoc edits

* AbstractFirebaseAuth docstring edits

* Update src/main/java/com/google/firebase/auth/UserRecord.java

Author: kevinthecheung

src/main/java/com/google/firebase/auth/AbstractFirebaseAuth.java

@@ -555,9 +555,9 @@ protected UserRecord execute() throws FirebaseAuthException {
   }
 
   /**
-   * Gets the user data for the user corresponding to a given provider id.
+   * Gets the user data for the user corresponding to a given provider ID.
    *
-   * @param providerId Identifier for the given federated provider, for example,
+   * @param providerId Identifier for the given federated provider: for example,
    *     "google.com" for the Google provider.
    * @param uid The user identifier with the given provider.
    * @return A {@link UserRecord} instance.
@@ -571,9 +571,9 @@ public UserRecord getUserByProviderUid(
   }
 
   /**
-   * Gets the user data for the user corresponding to a given provider id.
+   * Gets the user data for the user corresponding to a given provider ID.
    *
-   * @param providerId Identifer for the given federated provider, for example,
+   * @param providerId Identifer for the given federated provider: for example,
    *     "google.com" for the Google provider.
    * @param uid The user identifier with the given provider.
    * @return An {@code ApiFuture} which will complete successfully with a {@link UserRecord}

src/main/java/com/google/firebase/auth/UserRecord.java

@@ -576,8 +576,8 @@ public UpdateRequest setCustomClaims(Map<String,Object> customClaims) {
      *
      * <p>Linking a provider to an existing user account does not invalidate the
      * refresh token of that account. In other words, the existing account
-     * would continue to be able to access resources, despite not having used
-     * the newly linked provider to log in. If you wish to force the user to
+     * continues to be able to access resources, despite not having used
+     * the newly linked provider to sign in. If you wish to force the user to
      * authenticate with this new provider, you need to (a) revoke their
      * refresh token (see
      * https://firebase.google.com/docs/auth/admin/manage-sessions#revoke_refresh_tokens),