Updated javadocs and licenses per @mrioan

Author: dogeared

api/src/main/java/com/stormpath/sdk/challenge/google/GoogleAuthenticatorCreateChallengeRequest.java

@@ -1,5 +1,5 @@
 /*
- * Copyright 2016 Stormpath, Inc.
+ * Copyright 2017 Stormpath, Inc.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -17,4 +17,11 @@
 
 import com.stormpath.sdk.challenge.CreateChallengeRequest;
 
+/**
+ * A Google Authenticator specific create challenge request
+ *
+ * Google Authenticator challenges can validate a code at the same time that the challenge is created.
+ *
+ * @since 1.4.0
+ */
 public interface GoogleAuthenticatorCreateChallengeRequest extends CreateChallengeRequest {}

api/src/main/java/com/stormpath/sdk/challenge/google/GoogleAuthenticatorCreateChallengeRequestBuilder.java

@@ -1,5 +1,5 @@
 /*
- * Copyright 2016 Stormpath, Inc.
+ * Copyright 2017 Stormpath, Inc.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -17,7 +17,19 @@
 
 import com.stormpath.sdk.challenge.CreateChallengeRequestBuilder;
 
+/**
+ * A builder to construct {@link GoogleAuthenticatorCreateChallengeRequest}s Google Authenticator specific create challenge requests.
+ *
+ * Google Authenticator can both create the challenge and set the code in one API call.
+ * See {@link com.stormpath.sdk.factor.google.GoogleAuthenticatorFactor}
+ *
+ * @since 1.4.0
+ */
 public interface GoogleAuthenticatorCreateChallengeRequestBuilder  extends CreateChallengeRequestBuilder<GoogleAuthenticatorChallenge> {
 
+    /**
+     * @param code to be used to validate the challenge for the {@link com.stormpath.sdk.factor.google.GoogleAuthenticatorFactor}
+     * @return GoogleAuthenticatorCreateChallengeRequestBuilder for method chaining with the builder pattern
+     */
     GoogleAuthenticatorCreateChallengeRequestBuilder withCode(String code);
 }

api/src/main/java/com/stormpath/sdk/factor/google/GoogleAuthenticatorFactor.java

@@ -22,8 +22,21 @@
  * A {@code GoogleAuthenticatorFactor} is a Factor that represents a two-step verification services using
  * the Time-based One-time Password Algorithm (TOTP) and HMAC-based One-time Password Algorithm (HOTP),
  * for authenticating users of mobile applications by Google.
- * When issuing a challenge via an GoogleAuthenticatorFactor, a code is sent to the Google Authenticator app,
- * and the user can enter the received code back into the system to verify/complete the challenge.
+ * <p/>
+ * The TOTP algorithm determines the next valid code without the requirement for any communication between server and
+ * TOTP client.
+ * <p/>
+ * As such, the challenge can be created with the code at the same time:
+ * <p/>
+ * <pre>
+ * GoogleAuthenticatorChallenge challenge = client.instantiate(GoogleAuthenticatorChallenge.class);
+ * challenge = (GoogleAuthenticatorChallenge) googleAuthenticatorFactor.createChallenge(
+ *     Challenges.GOOGLE_AUTHENTICATOR
+ *         .newCreateRequestFor(challenge)
+ *         <b>.withCode(code)</b>
+ *         .build()
+ *     );
+ * </pre>
  *
  * @since 1.1.0
  */

impl/src/main/java/com/stormpath/sdk/impl/challenge/google/DefaultGoogleAuthenticatorCreateChallengeRequest.java

@@ -1,5 +1,5 @@
 /*
- * Copyright 2016 Stormpath, Inc.
+ * Copyright 2017 Stormpath, Inc.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -20,6 +20,9 @@
 import com.stormpath.sdk.challenge.google.GoogleAuthenticatorCreateChallengeRequest;
 import com.stormpath.sdk.impl.challenge.DefaultCreateChallengeRequest;
 
+/**
+ * @since 1.4.0
+ */
 public class DefaultGoogleAuthenticatorCreateChallengeRequest extends DefaultCreateChallengeRequest implements GoogleAuthenticatorCreateChallengeRequest {
 
     public DefaultGoogleAuthenticatorCreateChallengeRequest(Challenge challenge, ChallengeOptions options) {

impl/src/main/java/com/stormpath/sdk/impl/challenge/google/DefaultGoogleAuthenticatorCreateChallengeRequestBuilder.java

@@ -1,5 +1,5 @@
 /*
- * Copyright 2016 Stormpath, Inc.
+ * Copyright 2017 Stormpath, Inc.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -20,6 +20,9 @@
 import com.stormpath.sdk.challenge.google.GoogleAuthenticatorCreateChallengeRequestBuilder;
 import com.stormpath.sdk.impl.challenge.DefaultCreateChallengeRequestBuilder;
 
+/**
+ * @since 1.4.0
+ */
 public class DefaultGoogleAuthenticatorCreateChallengeRequestBuilder extends DefaultCreateChallengeRequestBuilder<GoogleAuthenticatorChallenge> implements GoogleAuthenticatorCreateChallengeRequestBuilder {
 
     public DefaultGoogleAuthenticatorCreateChallengeRequestBuilder(GoogleAuthenticatorChallenge challenge) {