Responding to PR feedback

Author: Rachel Prince

firebase-appdistribution/src/main/java/com/google/firebase/appdistribution/AppDistributionRelease.java

@@ -19,8 +19,8 @@
 import com.google.auto.value.AutoValue;
 
 /**
- * The release information returned by {@link checkForNewRelease} when a new version is available
- * for the signed in tester.
+ * The release information returned by {@link FirebaseAppDistribution#checkForNewRelease} when a new
+ * version is available for the signed in tester.
  */
 @AutoValue
 public abstract class AppDistributionRelease {

firebase-appdistribution/src/main/java/com/google/firebase/appdistribution/FirebaseAppDistribution.java

@@ -258,7 +258,7 @@ public Task<Void> signInTester() {
 
   /**
    * Returns an {@link AppDistributionRelease} if an update is available for the current signed in
-   * tester or {@code null} otherwise.
+   * tester, or {@code null} otherwise.
    */
   @NonNull
   public synchronized Task<AppDistributionRelease> checkForNewRelease() {
@@ -291,9 +291,10 @@ public synchronized Task<AppDistributionRelease> checkForNewRelease() {
   }
 
   /**
-   * Updates app to the {@link AppDistributionRelease} returned by {@link #checkForNewRelease}. If
-   * the newest release is an APK, downloads the binary and starts an installation. If the newest
-   * release is an AAB, directs the tester to the Play app to complete the download and
+   * Updates app to the {@link AppDistributionRelease} returned by {@link #checkForNewRelease}.
+   *
+   * <p>If the newest release is an APK, downloads the binary and starts an installation. If the
+   * newest release is an AAB, directs the tester to the Play app to complete the download and
    * installation.
    *
    * <p>Cancels task with {@link Status#UPDATE_NOT_AVAILABLE} if no new release is cached from

firebase-appdistribution/src/main/java/com/google/firebase/appdistribution/UpdateProgress.java

@@ -30,15 +30,17 @@ static UpdateProgress.Builder builder() {
   /**
    * The number of bytes downloaded so far for an APK.
    *
-   * @returns -1 if called when updating to an AAB or if no new release is available.
+   * @returns the number of bytes downloaded, or -1 if called when updating to an AAB or if no new
+   *     release is available.
    */
   @NonNull
   public abstract long getApkBytesDownloaded();
 
   /**
    * The file size of the APK file to download in bytes.
    *
-   * @returns -1 if called when updating to an AAB or if no new release is available.
+   * @returns the file size in bytes, or -1 if called when updating to an AAB or if no new release
+   *     is available.
    */
   @NonNull
   public abstract long getApkFileTotalBytes();

firebase-appdistribution/src/main/java/com/google/firebase/appdistribution/UpdateTask.java

@@ -26,18 +26,18 @@
  */
 public abstract class UpdateTask extends Task<Void> {
   /**
-   * Adds a listener that is called periodically while the UpdateTask executes.
+   * Adds a listener that is called periodically while this {@link UpdateTask} executes.
    *
-   * @return this Task
+   * @return this {@link UpdateTask}
    */
   @NonNull
   public abstract UpdateTask addOnProgressListener(@NonNull OnProgressListener listener);
 
   /**
-   * Adds a listener that is called periodically while the UpdateTask executes.
+   * Adds a listener that is called periodically while {@link UpdateTask} executes.
    *
    * @param executor the executor to use to call the listener
-   * @return this Task
+   * @return this {@link UpdateTask}
    */
   @NonNull
   public abstract UpdateTask addOnProgressListener(