Add javadoc

Ajay Kannan · Ajay Kannan · commit 8c353ecbc62a · 2016-03-07T08:27:49.000-08:00
diff --git a/gcloud-java-core/src/main/java/com/google/gcloud/AuthCredentials.java b/gcloud-java-core/src/main/java/com/google/gcloud/AuthCredentials.java
@@ -132,6 +132,12 @@ public RestorableState<AuthCredentials> capture() {
     }
   }
 
+  /**
+   * Represents service account credentials.
+   *
+   * @see <a href="https://cloud.google.com/docs/authentication#user_accounts_and_service_accounts">
+   *     User accounts and service accounts</a>
+   */
   public static class ServiceAccountAuthCredentials extends AuthCredentials {
 
     private final String account;
@@ -195,6 +201,14 @@ public RestorableState<AuthCredentials> capture() {
     }
   }
 
+  /**
+   * Represents Application Default Credentials, which are credentials that are inferred from the
+   * runtime environment.
+   *
+   * @see <a
+   *     href="https://developers.google.com/identity/protocols/application-default-credentials">
+   *     Google Application Default Credentials</a>
+   */
   public static class ApplicationDefaultAuthCredentials extends AuthCredentials {
 
     private GoogleCredentials googleCredentials;
@@ -243,6 +257,11 @@ public RestorableState<AuthCredentials> capture() {
     }
   }
 
+  /**
+   * Represents that requests sent to the server should not be authenticated. This is typically
+   * useful when using the local service emulators, such as {@code LocalGcdHelper} and
+   * {@code LocalResourceManagerHelper}.
+   */
   public static class NoAuthCredentials extends AuthCredentials {
 
     private static final AuthCredentials INSTANCE = new NoAuthCredentials();
@@ -309,7 +328,9 @@ public static ServiceAccountAuthCredentials createFor(String account, PrivateKey
   }
 
   /**
-   * Creates a placeholder denoting that no credentials should be used.
+   * Creates a placeholder denoting that no credentials should be used. This is typically useful
+   * when using the local service emulators, such as {@code LocalGcdHelper} and
+   * {@code LocalResourceManagerHelper}.
    */
   public static AuthCredentials noAuth() {
     return NoAuthCredentials.INSTANCE;
