remove 'new' mentions in documentation

Author: lbalmaceda

README.md

@@ -36,7 +36,7 @@ The Auth0 Authentication API and User's Management API are available for Android
 
 The implementation is based on the [Authentication API Docs](https://auth0.com/docs/api/authentication).
 
-Create a new `AuthAPI` instance by providing the client data from the [dashboard](https://manage.auth0.com/#/clients).
+Create an `AuthAPI` instance by providing the client data from the [dashboard](https://manage.auth0.com/#/clients).
 
 ```java
 AuthAPI auth = new AuthAPI("{YOUR_DOMAIN}", "{YOUR_CLIENT_ID}", "{YOUR_CLIENT_SECRET}");
@@ -71,7 +71,7 @@ String url = auth.logoutUrl("https://me.auth0.com/home", true)
 ```
 
 ### UserInfo - /userinfo
-Creates a new request to get the user information associated to a given access token. This will only work if the token has been granted the `openid` scope.
+Creates a request to get the user information associated to a given access token. This will only work if the token has been granted the `openid` scope.
 
 `Request<UserInfo> userInfo(String accessToken)`
 
@@ -89,7 +89,7 @@ try {
 ```
 
 ### Reset Password - /dbconnections/change_password
-Creates a new request to reset the user's password. This will only work for db connections.
+Creates a request to reset the user's password. This will only work for db connections.
 
 `Request resetPassword(String email, String connection)`
 
@@ -107,7 +107,7 @@ try {
 
 
 ### Sign Up - /dbconnections/signup
-Creates a new request to create a new user. Up to 10 additional Sign Up fields can be added to the request. This will only work for db connections.
+Creates a request to create a user. Up to 10 additional Sign Up fields can be added to the request. This will only work for db connections.
 
 `SignUpRequest signUp(String email, String username, String password, String connection)`
 
@@ -131,7 +131,7 @@ try {
 
 ### Exchange the Authorization Code - /oauth/token
 
-Creates a new request to exchange the `code` previously obtained by calling the /authorize endpoint. The redirect uri must be the one sent in the /authorize call.
+Creates a request to exchange the `code` previously obtained by calling the /authorize endpoint. The redirect uri must be the one sent in the /authorize call.
 
 `AuthRequest exchangeCode(String code, String redirectUri)`
 
@@ -151,7 +151,7 @@ try {
 
 ### Log In with Password - /oauth/token
 
-Creates a new request to log in the user with `username` and `password`. The connection used is the one defined as "Default Directory" in the account settings.
+Creates a request to log in the user with `username` and `password`. The connection used is the one defined as "Default Directory" in the account settings.
 
 `AuthRequest login(String emailOrUsername, String password)`
 
@@ -171,7 +171,7 @@ try {
 
 ### Log In with Password Realm - /oauth/token
 
-Creates a new request to log in the user with `username` and `password` using the Password Realm.
+Creates a request to log in the user with `username` and `password` using the Password Realm.
 
 `AuthRequest login(String emailOrUsername, String password, String realm)`
 
@@ -191,7 +191,7 @@ try {
 
 ### Request Token for Audience - /oauth/token
 
-Creates a new request to get a Token for the given Audience.
+Creates a request to get a Token for the given Audience.
 
 `AuthRequest requestToken(String audience)`
 
@@ -210,7 +210,7 @@ try {
 
 ### Revoke Refresh Token
 
-Creates a new request to revoke an existing Refresh Token.
+Creates a request to revoke an existing Refresh Token.
 
 `Request<Void> revokeToken(String refreshToken)`
 
@@ -228,7 +228,7 @@ try {
 
 ### Renew Authentication
 
-Creates a new request to renew the authentication and get fresh new credentials using a valid Refresh Token.
+Creates a request to renew the authentication and get fresh new credentials using a valid Refresh Token.
 
 `AuthRequest renewAuth(String refreshToken)`
 
@@ -249,7 +249,7 @@ try {
 
 The implementation is based on the [Management API Docs](https://auth0.com/docs/api/management/v2).
 
-Create a new `ManagementAPI` instance by providing the domain from the [client dashboard](https://manage.auth0.com/#/clients) and the API Token. Click [here](https://auth0.com/docs/api/management/v2#!/Introduction/Getting_an_API_token) for more information on how to obtain a valid API Token.
+Create a `ManagementAPI` instance by providing the domain from the [client dashboard](https://manage.auth0.com/#/clients) and the API Token. Click [here](https://auth0.com/docs/api/management/v2#!/Introduction/Getting_an_API_token) for more information on how to obtain a valid API Token.
 
 ```java
 ManagementAPI mgmt = new ManagementAPI("{YOUR_DOMAIN}", "{YOUR_API_TOKEN}");
@@ -277,7 +277,7 @@ The Management API is divided into different entities. Each of them have the lis
 
 #### List
 
-Creates a new request to list the Users. An API Token with scope `read:users` is needed. If you want the identities.access_token property to be included, you will also need the scope `read:user_idp_tokens`.
+Creates a request to list the Users. An API Token with scope `read:users` is needed. If you want the identities.access_token property to be included, you will also need the scope `read:user_idp_tokens`.
 You can pass an optional Filter to narrow the results in the response.
 
 `Request<UsersPage> list(UserFilter filter)`
@@ -297,7 +297,7 @@ try {
 
 #### Get
 
-Creates a new request to get a User. An API Token with scope `read:users` is needed. If you want the identities.access_token property to be included, you will also need the scope `read:user_idp_tokens`.
+Creates a request to get a User. An API Token with scope `read:users` is needed. If you want the identities.access_token property to be included, you will also need the scope `read:user_idp_tokens`.
 You can pass an optional Filter to narrow the results in the response.
 
 `Request<User> get(String userId, UserFilter filter)`
@@ -317,7 +317,7 @@ try {
 
 #### Create
 
-Creates a new request to create a new User. An API Token with scope `create:users` is needed.
+Creates a request to create a User. An API Token with scope `create:users` is needed.
 
 `Request<User> create(User user)`
 
@@ -336,7 +336,7 @@ try {
 
 #### Delete
 
-Creates a new request to delete a User. An API Token with scope `delete:users` is needed.
+Creates a request to delete a User. An API Token with scope `delete:users` is needed.
 
 `Request delete(String userId)`
 
@@ -354,7 +354,7 @@ try {
 
 #### Update
 
-Creates a new request to update a User. An API Token with scope `update:users` is needed. If you're updating app_metadata you'll also need `update:users_app_metadata` scope.
+Creates a request to update a User. An API Token with scope `update:users` is needed. If you're updating app_metadata you'll also need `update:users_app_metadata` scope.
 
 `Request<User> update(String userId, User user)`
 
@@ -373,7 +373,7 @@ try {
 
 #### Get Guardian Enrollments
 
-Creates a new request to list the User's Guardian Enrollments. An API Token with scope `read:users` is needed.
+Creates a request to list the User's Guardian Enrollments. An API Token with scope `read:users` is needed.
 
 `Request<List<Enrollment>> getEnrollments(String userId)`
 
@@ -391,7 +391,7 @@ try {
 
 #### Get Log Events
 
-Creates a new request to list the User's Log Events. An API Token with scope `read:logs` is needed.
+Creates a request to list the User's Log Events. An API Token with scope `read:logs` is needed.
 You can pass an optional Filter to narrow the results in the response.
 
 `Request<LogEventsPage> getLogEvents(String userId, LogEventFilter filter)`
@@ -412,7 +412,7 @@ try {
 
 #### Delete Multifactor Provider
 
-Creates a new request to delete the User's Multifactor Provider. An API Token with scope `update:users` is needed.
+Creates a request to delete the User's Multifactor Provider. An API Token with scope `update:users` is needed.
 
 `Request deleteMultifactorProvider(String userId, String provider)`
 
@@ -430,7 +430,7 @@ try {
 
 #### Rotate Recovery Code
 
-Creates a new request to rotate the User's Recovery Code. An API Token with scope `update:users` is needed.
+Creates a request to rotate the User's Recovery Code. An API Token with scope `update:users` is needed.
 
 `Request<RecoveryCode> rotateRecoveryCode(String userId)`
 
@@ -448,7 +448,7 @@ try {
 
 #### Link Identities
 
-Creates a new request to link two User identities. An API Token with scope `update:users` is needed.
+Creates a request to link two User identities. An API Token with scope `update:users` is needed.
 
 `Request<List<Identity>> linkIdentity(String primaryUserId, String secondaryUserId, String provider, String connectionId)`
 
@@ -466,7 +466,7 @@ try {
 
 #### Un-Link Identities
 
-Creates a new request to un-link two User identities. An API Token with scope `update:users` is needed.
+Creates a request to un-link two User identities. An API Token with scope `update:users` is needed.
 
 `Request<List<Identity>> unlinkIdentity(String primaryUserId, String secondaryUserId, String provider)`
 

src/main/java/com/auth0/client/auth/AuthAPI.java

@@ -103,7 +103,7 @@ private String createBaseUrl(String domain) {
     }
 
     /**
-     * Creates a new instance of the {@link AuthorizeUrlBuilder} with the given redirect url.
+     * Creates an instance of the {@link AuthorizeUrlBuilder} with the given redirect url.
      * i.e.:
      * <pre>
      * {@code
@@ -127,7 +127,7 @@ public AuthorizeUrlBuilder authorizeUrl(String redirectUri) {
     }
 
     /**
-     * Creates a new instance of the {@link LogoutUrlBuilder} with the given return-to url.
+     * Creates an instance of the {@link LogoutUrlBuilder} with the given return-to url.
      * i.e.:
      * <pre>
      * {@code
@@ -217,7 +217,7 @@ public Request resetPassword(String email, String connection) {
     }
 
     /**
-     * Creates a new sign up request with the given credentials and database connection.
+     * Creates a sign up request with the given credentials and database connection.
      * "Requires Username" option must be turned on in the Connection's configuration first.
      * i.e.:
      * <pre>
@@ -251,7 +251,7 @@ public SignUpRequest signUp(String email, String username, String password, Stri
     }
 
     /**
-     * Creates a new sign up request with the given credentials and database connection.
+     * Creates a sign up request with the given credentials and database connection.
      * i.e.:
      * <pre>
      * {@code
@@ -294,7 +294,7 @@ public SignUpRequest signUp(String email, String password, String connection) {
     }
 
     /**
-     * Creates a new log in request using the 'Password' grant and the given credentials.
+     * Creates a log in request using the 'Password' grant and the given credentials.
      * i.e.:
      * <pre>
      * {@code
@@ -333,7 +333,7 @@ public AuthRequest login(String emailOrUsername, String password) {
     }
 
     /**
-     * Creates a new log in request using the 'Password Realm' grant and the given credentials.
+     * Creates a log in request using the 'Password Realm' grant and the given credentials.
      * Default used realm and audience are defined in the "API Authorization Settings" in the account's advanced settings in the Auth0 Dashboard.
      * <pre>
      * {@code
@@ -375,7 +375,7 @@ public AuthRequest login(String emailOrUsername, String password, String realm)
     }
 
     /**
-     * Creates a new request to get a Token for the given audience using the 'Client Credentials' grant.
+     * Creates a request to get a Token for the given audience using the 'Client Credentials' grant.
      * Default used realm is defined in the "API Authorization Settings" in the account's advanced settings in the Auth0 Dashboard.
      * <pre>
      * {@code
@@ -411,7 +411,7 @@ public AuthRequest requestToken(String audience) {
     }
 
     /**
-     * Creates a new request to revoke an existing Refresh Token.
+     * Creates a request to revoke an existing Refresh Token.
      * <pre>
      * {@code
      * AuthAPI auth = new AuthAPI("me.auth0.com", "B3c6RYhk1v9SbIJcRIOwu62gIUGsnze", "2679NfkaBn62e6w5E8zNEzjr-yWfkaBne");
@@ -445,7 +445,7 @@ public Request<Void> revokeToken(String refreshToken) {
 
 
     /**
-     * Creates a new request to renew the authentication and get fresh new credentials using a valid Refresh Token and the 'refresh_token' grant.
+     * Creates a request to renew the authentication and get fresh new credentials using a valid Refresh Token and the 'refresh_token' grant.
      * <pre>
      * {@code
      * AuthAPI auth = new AuthAPI("me.auth0.com", "B3c6RYhk1v9SbIJcRIOwu62gIUGsnze", "2679NfkaBn62e6w5E8zNEzjr-yWfkaBne");
@@ -479,7 +479,7 @@ public AuthRequest renewAuth(String refreshToken) {
     }
 
     /**
-     * Creates a new request to exchange the code obtained in the /authorize call using the 'Authorization Code' grant.
+     * Creates a request to exchange the code obtained in the /authorize call using the 'Authorization Code' grant.
      * <pre>
      * {@code
      * AuthAPI auth = new AuthAPI("me.auth0.com", "B3c6RYhk1v9SbIJcRIOwu62gIUGsnze", "2679NfkaBn62e6w5E8zNEzjr-yWfkaBne");

src/main/java/com/auth0/client/auth/AuthorizeUrlBuilder.java

@@ -18,7 +18,7 @@ public class AuthorizeUrlBuilder {
     private final HashMap<String, String> parameters;
 
     /**
-     * Creates a new instance of the {@link AuthorizeUrlBuilder} using the given domain and base parameters.
+     * Creates an instance of the {@link AuthorizeUrlBuilder} using the given domain and base parameters.
      *
      * @param domain      the domain to use for this URL. Must be a valid URL.
      * @param clientId    the client_id value to set

src/main/java/com/auth0/client/auth/LogoutUrlBuilder.java

@@ -18,7 +18,7 @@ public class LogoutUrlBuilder {
     private final HashMap<String, String> parameters;
 
     /**
-     * Creates a new instance of the {@link LogoutUrlBuilder} using the given domain and base parameters.
+     * Creates a instance of the {@link LogoutUrlBuilder} using the given domain and base parameters.
      *
      * @param domain      the domain to use for this URL. Must be a valid URL.
      * @param clientId    the client_id value to set

src/main/java/com/auth0/client/mgmt/ClientGrantsEntity.java

@@ -40,7 +40,7 @@ public Request<List<ClientGrant>> list() {
     }
 
     /**
-     * Create a new Client Grant. A token with scope create:client_grants is needed.
+     * Create a Client Grant. A token with scope create:client_grants is needed.
      * See https://auth0.com/docs/api/management/v2#!/Client_Grants/post_client_grants
      *
      * @param clientId the client id to associate this grant with.

src/main/java/com/auth0/client/mgmt/ConnectionsEntity.java

@@ -74,7 +74,7 @@ public Request<Connection> get(String connectionId, ConnectionFilter filter) {
     }
 
     /**
-     * Create a new Connection. A token with scope create:connections is needed.
+     * Create a Connection. A token with scope create:connections is needed.
      * See https://auth0.com/docs/api/management/v2#!/Connections/post_connections
      *
      * @param connection the connection data to set.

src/main/java/com/auth0/client/mgmt/DeviceCredentialsEntity.java

@@ -47,7 +47,7 @@ public Request<List<DeviceCredentials>> list(DeviceCredentialsFilter filter) {
     }
 
     /**
-     * Create a new Device Credentials. A token with scope create:current_user_device_credentials is needed.
+     * Create a Device Credentials. A token with scope create:current_user_device_credentials is needed.
      * See https://auth0.com/docs/api/management/v2#!/Device_Credentials/post_device_credentials
      *
      * @param deviceCredentials the device credentials data to set.

src/main/java/com/auth0/client/mgmt/GuardianEntity.java

@@ -22,7 +22,7 @@ public class GuardianEntity extends BaseManagementEntity {
     }
 
     /**
-     * Create a new Guardian Enrollment Ticket. A token with scope create:guardian_enrollment_tickets is needed.
+     * Create a Guardian Enrollment Ticket. A token with scope create:guardian_enrollment_tickets is needed.
      *
      * @param enrollmentTicket the enrollment ticket data to set.
      * @return a Request to execute.

src/main/java/com/auth0/client/mgmt/ManagementAPI.java

@@ -9,7 +9,7 @@
 
 /**
  * Class that provides an implementation of the Management API methods defined in https://auth0.com/docs/api/management/v2.
- * To begin create a new instance of {@link #ManagementAPI(String, String)} using the tenant domain and API token.
+ * To begin create an instance of {@link #ManagementAPI(String, String)} using the tenant domain and API token.
  */
 @SuppressWarnings("WeakerAccess")
 public class ManagementAPI {
@@ -21,7 +21,7 @@ public class ManagementAPI {
     private final HttpLoggingInterceptor logging;
 
     /**
-     * Create a new instance with the given tenant's domain and API token.
+     * Create an instance with the given tenant's domain and API token.
      *
      * @param domain   the tenant's domain.
      * @param apiToken the token to authenticate the calls with. See the "Getting an API token" section to learn how to obtain a token.

src/main/java/com/auth0/client/mgmt/RulesEntity.java

@@ -74,7 +74,7 @@ public Request<Rule> get(String ruleId, RulesFilter filter) {
     }
 
     /**
-     * Create a new Rule. A token with scope create:rules is needed.
+     * Create a Rule. A token with scope create:rules is needed.
      * See https://auth0.com/docs/api/management/v2#!/Rules/post_rules
      *
      * @param rule the rule data to set