Fix JavaDoc errors and warnings

auth0/src/main/java/com/auth0/android/Auth0.java

@@ -35,7 +35,7 @@
 import com.squareup.okhttp.HttpUrl;
 
 /**
- * Represents your Auth0 account information (clientId & domain),
+ * Represents your Auth0 account information (clientId {@literal &} domain),
  * and it's used to obtain clients for Auth0's APIs.
  * <pre>{@code
  * Auth0 auth0 = new Auth0("YOUR_CLIENT_ID", "YOUR_DOMAIN");
@@ -65,7 +65,7 @@ public Auth0(@NonNull Context context) {
     }
 
     /**
-     * Creates a new object using clientId & domain
+     * Creates a new object using clientId {@literal &} domain
      *
      * @param clientId of your Auth0 application
      * @param domain   of your Auth0 account
@@ -167,13 +167,17 @@ public void setOIDCConformant(boolean enabled) {
 
     /**
      * If the clients works in OIDC conformant mode or not
+     *
+     * @return whether the android client is OIDC conformant or not.
      */
     public boolean isOIDCConformant() {
         return oidcConformant;
     }
 
     /**
-     * @return if every Request, Response and other sensitive information should be logged.
+     * Getter for the HTTP logger is enabled or not.
+     *
+     * @return whether every Request, Response and other sensitive information should be logged or not.
      */
     public boolean isLoggingEnabled() {
         return loggingEnabled;

auth0/src/main/java/com/auth0/android/authentication/ParameterBuilder.java

@@ -32,15 +32,16 @@
 
 /**
  * Builder for Auth0 Authentication API parameters
- * <p/>
  * You can build your parameters like this
- * <pre><code>
- *     Map<String, Object> parameters = ParameterBuilder.newBuilder()
- *                                                      .setClientId("{CLIENT_ID}")
- *                                                      .setConnection("{CONNECTION}")
- *                                                      .set("{PARAMETER_NAME}", "{PARAMETER_VALUE}")
- *                                                      .asDictionary();
- * </code></pre>
+ * <pre>
+ * {@code
+ * Map<String, Object> parameters = ParameterBuilder.newBuilder()
+ *      .setClientId("{CLIENT_ID}")
+ *      .setConnection("{CONNECTION}")
+ *      .set("{PARAMETER_NAME}", "{PARAMETER_VALUE}")
+ *      .asDictionary();
+ * }
+ * </pre>
  *
  * @see ParameterBuilder#newBuilder()
  * @see ParameterBuilder#newAuthenticationBuilder()

auth0/src/main/java/com/auth0/android/management/UsersAPIClient.java

@@ -49,11 +49,12 @@
 
 /**
  * API client for Auth0 Management API.
- * <p/>
- * <pre><code>
+ * <pre>
+ * {@code
  * Auth0 auth0 = new Auth0("your_client_id", "your_domain");
  * UsersAPIClient client = new UsersAPIClient(auth0);
- * </code></pre>
+ * }
+ * </pre>
  *
  * @see <a href="https://auth0.com/docs/api/management/v2">Auth API docs</a>
  */
@@ -135,7 +136,8 @@ public void setUserAgent(String userAgent) {
     /**
      * Link a user identity calling <a href="https://auth0.com/docs/link-accounts#the-api">'/api/v2/users/:primaryUserId/identities'</a> endpoint
      * Example usage:
-     * <pre><code>
+     * <pre>
+     * {@code
      * client.link("{auth0 primary user id}", "{user secondary token}")
      *      .start(new BaseCallback<List<UserIdentity>>() {
      *          {@literal}Override
@@ -144,7 +146,8 @@ public void setUserAgent(String userAgent) {
      *          {@literal}Override
      *          public void onFailure(ManagementException error) {}
      *      });
-     * </code></pre>
+     * }
+     * </pre>
      *
      * @param primaryUserId  of the identity to link
      * @param secondaryToken of the secondary identity obtained after login
@@ -173,7 +176,8 @@ public Request<List<UserIdentity>, ManagementException> link(String primaryUserI
     /**
      * Unlink a user identity calling <a href="https://auth0.com/docs/link-accounts#unlinking-accounts">'/api/v2/users/:primaryToken/identities/secondaryProvider/secondaryUserId'</a> endpoint
      * Example usage:
-     * <pre><code>
+     * <pre>
+     * {@code
      * client.unlink("{auth0 primary user id}", {auth0 secondary user id}, "{secondary provider}")
      *      .start(new BaseCallback<List<UserIdentity>>() {
      *          {@literal}Override
@@ -182,7 +186,8 @@ public Request<List<UserIdentity>, ManagementException> link(String primaryUserI
      *          {@literal}Override
      *          public void onFailure(ManagementException error) {}
      *      });
-     * </code></pre>
+     * }
+     * </pre>
      *
      * @param primaryUserId     of the primary identity to unlink
      * @param secondaryUserId   of the secondary identity you wish to unlink from the main one.
@@ -209,7 +214,8 @@ public Request<List<UserIdentity>, ManagementException> unlink(String primaryUse
     /**
      * Update the user_metadata calling <a href="https://auth0.com/docs/api/management/v2#!/Users/patch_users_by_id">'/api/v2/users/:token'</a> endpoint
      * Example usage:
-     * <pre><code>
+     * <pre>
+     * {@code
      * client.updateMetadata("{user id}", "{user metadata}")
      *      .start(new BaseCallback<UserProfile>() {
      *          {@literal}Override
@@ -218,7 +224,8 @@ public Request<List<UserIdentity>, ManagementException> unlink(String primaryUse
      *          {@literal}Override
      *          public void onFailure(ManagementException error) {}
      *      });
-     * </code></pre>
+     * }
+     * </pre>
      *
      * @param userId       of the primary identity to unlink
      * @param userMetadata to merge with the existing one

auth0/src/main/java/com/auth0/android/request/AuthorizableRequest.java

@@ -27,13 +27,16 @@
 import com.auth0.android.Auth0Exception;
 
 /**
- * Interface for a Auth0 request that need Authorization using a JWT
- * @param <T>
+ * Interface for a Auth0 request that need Authorization using a JWT.
+ *
+ * @param <T> the type this request will return on success.
+ * @param <U> the {@link Auth0Exception} type this request will return on failure.
  */
 public interface AuthorizableRequest<T, U extends Auth0Exception> extends ParameterizableRequest<T, U> {
 
     /**
      * Set the JWT used in 'Authorization' header value
+     *
      * @param jwt token to send to the API
      * @return itself
      */

auth0/src/main/java/com/auth0/android/request/ParameterizableRequest.java

@@ -31,20 +31,23 @@
 /**
  * Defines a request that can be configured (payload and headers)
  *
- * @param <T>
+ * @param <T> the type this request will return on success.
+ * @param <U> the {@link Auth0Exception} type this request will return on failure.
  */
 public interface ParameterizableRequest<T, U extends Auth0Exception> extends Request<T, U> {
 
     /**
      * Add parameters to the request as a Map of Object with the keys as String
+     *
      * @param parameters to send with the request
      * @return itself
      */
     ParameterizableRequest<T, U> addParameters(Map<String, Object> parameters);
 
     /**
      * Add parameter to the request with a given name
-     * @param name of the parameter
+     *
+     * @param name  of the parameter
      * @param value of the parameter
      * @return itself
      */

auth0/src/main/java/com/auth0/android/request/Request.java

@@ -29,18 +29,22 @@
 
 /**
  * Defines a request that can be started
- * @param <T>
+ *
+ * @param <T> the type this request will return on success.
+ * @param <U> the {@link Auth0Exception} type this request will return on failure.
  */
 public interface Request<T, U extends Auth0Exception> {
 
     /**
      * Performs an async HTTP request against Auth0 API
+     *
      * @param callback called either on success or failure
      */
     void start(BaseCallback<T, U> callback);
 
     /**
      * Executes the HTTP request against Auth0 API (blocking the current thread)
+     *
      * @return the response on success
      * @throws Auth0Exception on failure
      */

auth0/src/main/java/com/auth0/android/result/Delegation.java

@@ -31,7 +31,7 @@
 
 /**
  * The result of a successful delegation to an Auth0 application that contains a new Auth0 'id_token'
- * See <a href="https://auth0.com/docs/auth-api#!#post--delegation">delegation</a> docs
+ * See <a href="https://auth0.com/docs/api/authentication#delegation">delegation</a> docs
  */
 public class Delegation {
     @SerializedName("id_token")